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This publication contains information about using the IBM 
System/3 Model 15 Communications Control Program 
(CCP). You should be familiar with the operating procedures 
for the Model 15 before operating the CCP. 


This publication describes generation and assignment in 
general terms. It gives the operating procedures for 
startup, CCP execution, and shutdown. A glossary is 
provided to define the important terms. The sample print- 
outs of the commands available to the system operator, 
debugging aid programs, and online testing information are 
also given. 


Prerequisite Publications 


You should be familiar with the information contained in 
the following system control program publications: 


@ /BM System/3 Model 15 Operator’s Guide, GC21-5075 

© /BM System/3 Model 15 System Messages, GC21-5076 

@ /BM System/3 Model 15 System Control Programming 
Concepts and Reference Manual, GC21-5162 (for 5704- 
SC2). 


@ /BM System/3 Model 15 System Control Programming 
Reference Manual, GC21-5077 (for 5704-SC1) 


Preface 


Related Publications 


The following publications contain additional information 
about the CCP: 


@ /BM System/3 Model 15 Communications Control 
Program System Reference Manual, GC21-7620 


@ /BM System/3 Communications Control Program 
Programmer’s Reference Manual, GC21-7579 


@ /BM System/3 Communications Control Program 
Terminal Operator’s Guide, GC21-7580 


e@ /BM System/3 Communications Control Program 
General Information Manual, GC21-7578 


@ /BM System/3 Communications Control Program 
Messages Manual, GC21-5170 


@ /BM System/3 Communications Control! Program 
System Design Guide, GC21-5165 


The following publications contain System/3 teleprocessing 
information: 


@ Data Communication Concepts, GC21-5169 


@ /BM System/3 Multiline/Multipoint Binary Synchronous 
Communications Reference Manual, GC21-7573 


@ /BM System/3 Multiple Line Terminal Adapter RPQ 
Program Reference and Component Description 


Manual, GC21-7560 


e@ /BM System/3 Models 8, 10, 12, and 15 Components 
Reference Manual, GA21-9236 
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Introduction 


CCP is the Communications Control Program for the IBM System/3 Model 15. 

You, the CCP system operator, require a better understanding of the system than 
the operator of a batch system. You must make decisions On your own in a variety 
of situations. Many of these decisions require a thorough understanding of the 
method of operation of the CCP. You have the ability to display and modify the 
current status of the CCP; therefore, you must understand the effect of your actions 
on the CCP and on the information processing system as a whole. 


Try to be involved as early as possible in planning for installation of the CCP. The 
IBM System/3 Communications Control! Program General Information Manual, 
GC21-7578, provides a general description of the CCP. Reading it will help you 
better understand a communications-based system. Prior to operating the system, 
you should become acquainted with the functions of the application programs in 
the system and with the files used by each program. You must be familiar with 
the configuration of the system and with the current status of the system. 


Someone else at your installation, an alternate or backup operator, should also be 
familiar with the operation of the CCP system in the event you are absent. The 
backup operator should be kept informed of any changes that are made to the 
system. 


Note: This manual makes references to BSCA and/or BSCC and to BSCA/BSCC lines 1, 
2,3, and 4. Program number 5704-SC1 supports BSCA lines 1 and 2; program number 
5704-SC2 supports BSCA lines 1 and 2 as well as BSCC lines 3 and 4. 
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Chapter 1. Role of the System Operator 


WHAT IS CCP 


The Communications Control Program (CCP) is a feature of System/3 Model 15 What is CCP 
that allows the Model 15 to support an online network of terminals. CCP enables 

terminals to call application programs as needed and permits those programs to 

access a common set of disk files. Several application programs are permitted to 

execute concurrently, though independently of one another, when sufficient main 

storage is available. CCP controls the environment in which these application 

programs run. 


ESTABLISHING THE CCP 


Establishing the CCP in your installation is basically a process of tailoring the Where to find the assign- 
distributed CCP to your installation requirements. This process is accomplished ment procedures 

in two stages: generation and assignment. The following descriptions of these 

stages are provided for your overall understanding of CCP. As system operator, 

you may not be required to perform CCP generation and assignment. However, 

if you are, you can find the operating procedures in /BM System/3 Model 15 CCP 

System Reference Manual, GC21-7620. 


Generation 


Generation is a process of creating a set of CCP object modules and subroutines Generation 
that satisfies the requirements of your installation. During generation, the 

maximum capabilities of the CCP and certain optional features, such as password 

security and 3270 Display Format Facility, are specified. 


Display Format Facility 


The IBM 3270 Display Format Facility (DFF) is a function of CCP that can be Display Format 
selected during CCP generation. DFF allows programs written in RPG ||, COBOL, Facility for 3270 
FORTRAN IV, and Basic Assembler to more easily control the display format for 

the 3270 Information Display System. 


The DFF is composed of the display format generator, printer format generator, 
and the display format control routine. The generators process special DFF 
specifications, build display or printer formats, and store the display or printer 
formats in an object library. The control routine processes requests for DFF services 
issued by application programs running under the CCP. 


Instructions for using the display format generator and printer format generator are 
given in /BM System/3 CCP Programmer’s Reference Manual, GC21-7579. 
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Assignment 


Assignment list 


Operational stage 


Assignment 


The assignment stage consists of running the assignment build program to describe 
an operating environment in more detail. Assignment is the process of defining one 
or more sets of terminals, files, programs, and system environments that will be 
available to the CCP. These assignment sets are recorded in the disk file $CCPFILE, 
which was created during the generation stage. The CCP runs under one of the 
assignment sets; that is, the CCP has access to a particular group of terminals, files, 
and programs. You can vary these resources by specifying a different assignment 
set or by modifying/suppressing certain items within an assignment set during 
startup. Therefore, you can control which programs are eligible to be called during 
a particular run, or you can restrict the use of certain files during a run. 


The information defined within an assignment set during the assignment stage is 
valid for any number of CCP runs. If a terminal, program, or file must be added or 
removed from the set or when aspects of the system environment change, the 
contents of the assignment set can be modified by repeating the assignment run, 
without performing generation again. 


Assignment information is printed using the assignment list program, $CCPAL. 
Procedures for running this program are given in /BM System/3 CCP System 
Reference Manual, GC21-7620. 


OPERATING THE CCP 


Once the CCP is established, you are ready to operate it. Operating the CCP 
includes: 


@ Startup — During startup, you load the generated CCP and are allowed to change 
certain specifications within an assignment set. 


@ Control — When startup logs O00 CCP STARTED, the CCP is ready to communi- 
cate with the terminals and application programs. You may exercise control 
over the system during this stage. You can determine if the system should accept 
new requests from terminal operators. While the system is in operation, you can 
initiate certain system actions, determine the system status, and alter the set of 
terminals permitted to access the system. You must also make decisions when 
exceptional situations (such as error conditions) are detected. 


@ Shutdown — When you tell the CCP to stop processing, the application programs 
are allowed to complete processing. 


COMMUNICATION WITH CCP 


Your communication with the CCP is through the 3277 Display Station and CRT/Keyboard 
Operator Console Keyboard (referred to as the conso/e in this manual). Messages 

from the system are displayed on the console; some messages require responses 

from you. Those messages requiring responses are preceded by an asterisk. 


During startup and during the last part of the operational stage of CCP, you may Responding to messages 
respond to messages issued by the CCP by pressing the PF12 key. When CCP is 

ready, the cursor is situated at the response position of the most recent message 

and ENTER RESPONSE is displayed on the lower line of the display. You may 

then enter that response or adjust the cursor to the response position of any 

unresponded message you desire. 


At any time during CCP execution, you may command a system action. Commands, Entering commands 
and the procedure for entering commands, are described in Chapter 3. Controlling 


the CCP after Startup. Messages are described in /BM System/3 CCP Messages, 
GC21-5170. 


TERMINALS USING CCP 


When terminals are communicating with the CCP, you will receive messages on the Communicating with 
console indicating what is happening. For instance, you are notified each time a terminals 

terminal operator attempts to sign-on. In some instances, the CCP does not 

automatically tell you what is happening, but you have commands that you can 


use to request information about the operation of the system. For example, you 
have commands available to: 


@ Tell you the current status of terminals on the system (see index entry display 
terminals command). 


@ Tell you the current status of active CCP user tasks (see index entry display 
users command). 


@ Tell you the current symbolic name and identifier of terminals on the system 
(see index entry display terminal assignments command). 
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SYSTEM AND PROGRAM INFORMATION 


Current system information and information about each application to be run on 
the system should be supplied to you by your data processing personnel. The 
following example sheets illustrate the type of information you need to run the 
system. 


Current System Information 
System information 1. General information about the system 
Terminals attached to the system 


Lines available on the system 
Files available 





2. Schedule of work 

Work performed by each terminal 

Work performed by system operator 

Total work schedule 
3. What is the current password or other security information 
4. What are the current data mode escape characters 


5. What assignment set should be used during startup 


6. What is the current default for signing-off each terminal. Hold or drop. 





7. What error recovery procedures are to be followed for certain terminal errors 
or while specific programs are running 


Keep a copy of the assignment set listing near the console for reference to the 
assignment set configurations. 


Program Information 


Application. CD atte 


Program Name Number______— Programmer 


10. 


Symbolic name of the progam i 


Function of the Program 


System resources used by the program 


Files How Used 


Terminal ID Symbolic name Location 


Main storage required 


Typical operating time 
Can input data be entered with the program request 

What input isexpected._ 
End message will be sent to terminal Yes No 

Special considerations 

Program restricted in any way 


Potential problems in suspending 
or cancelling the program before 


ithas finished 


Under what conditions can programs be cancelled 
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Chapter 2. Startup and Shutdown 


STARTUP 
Startup is the initiation of the resident CCP. The startup procedure consists of a Responding to startup 
sequence of prompts (messages) displayed on the console that allow you to prompts 


temporarily change specifications within an assignment. By answering the prompt 
with YES or Y, you are telling the CCP that you are requesting further prompting 
for individual changes. By entering an appropriate keyword (with a value if 
required), a change is made without further prompting. Keywords and values may 
be entered (one keyword and value at a time) until the ENTER key is pressed 
without any keyed input. By entering NO or N or by pressing the ENTER key, 
you are indicating that the value is to remain unchanged. 


The assignment specifications you change during startup remain changed only What you can change 
during the current CCP run and do not permanently alter the values given during at startup 
generation and assignment. The specifications you can change and the keyword 
used are: 

Keyword Purpose 

UNIT—xx Specify location (disk unit) of $CCPFILE 

SET—c Specify the ID character of an appropriate assignment 

set 
MINUPA—nnK Specify the minimum user program area size 


MINTPBUF—nnnnn Specify the number of bytes of main storage to be used 
for teleprocessing hold buffer 


PASSWORD—cccccc — Change the CCP security password (valid if option was 
selected during CCP generation) 


TRACEMLTA— }n at Specify use of the tracing routine within MLTA control 
routines: 


n Enter a specific line number 1-8. Keyword can be 
repeated for different line numbers. 


A ‘Enter A to use trace for all line numbers. 


TRACEMLMP Specify use of the tracing routine within BSCA 
control routines to trace for both lines 


TRACEM LMP—}n [At (5704-SC2 only) Specify use of the tracing routine 
within BSCA control routines: 


n Enter a specific line number 1 or 2. 
A Enter A to use trace for both line numbers. 
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Keyword Purpose 


TRACEBSCC—4n| At (5704-SC2 only) Specify use of the tracing routine 
within BSCC control routines: 


n Enter a specific line number 3 or 4. 
A Enter A to use trace for both line numbers. 


psccaLk-{1 (5704-SC2 only) Number of 256-byte blocks to be 
allocated for the use of the BSCC trace routine. Default 
is 1, maximum is 24 (6K). 


SUPPRESS Suppress use of the following facilities, specified in the 
assignment set, for the current CCP run: 
— Specific disk data files 
— Specific file reference-names (symbolic file names) 
— Specific programs 
-- Specific BSC (1-4) and/or MLTA (1-8) lines 
-- Specific DFF buffers (5704-SC2 only) 
— Specific terminals 
- Program request count 
— Use of specific terminals until later in the CCP run 


OFFLINE Place a terminal offline (not available) until later in the 
CCP run 


Before startup, the following operations must have been performed (see /BM 
System/3 Model 15 CCP System Reference Manual, GC21-7620 for descriptions of 
the procedures for these operations): 


CCP has been generated. 
At least one assignment set must have been entered into $CCPFILE. 


If user sign-on security is being employed, $CCPAU has been executed to load 
the user security information. 


All CCP application programs that may be requested during the CCP run have 

been compiled (or assembled) and have all been stored as specified in the assign- 

ment set, on either the CCP program pack or the DSM system pack as permanent 
members in the object library. Program 5704-SC2 allows CCP application programs to 
reside in an object library in any of the disk simulation areas. An exception to this is 

if EXECFIND-YES is specified in the PROGRAM assignment statement (5704-SC2 only}. 


All existing files to be used during the CCP run must be online prior to startup. 


If the display format facility is to be used, all formats required during the CCP 
run must be generated and must be online on the correct disk unit, prior to 
startup. An exception to this is if CCPFMT is to be used to find the format 
during CCP execution (5704-SC2 only). 


@ If you want a CCP trace, $STRACE must be loaded with TYPE-CCP prior to 
startup. (For 5704-SC2 only, an OCC-loadable trace is available that provides 
the same function and which may be initiated after startup.) 


® MLTERFIL (error file) has been initialized on the system pack (this operation 
is required for MLTA and for BSCA/BSCC control station only). For BSCC 
(5704-SC2 only), MLTERFIL must be two tracks. 


The CCP can be run in any program partition, but not in more than one Partition 
concurrently. tf multiple partitions are to be active, CCP should normally be run in 
the highest priority partition in the system. 


The non-CCP partition(s) may be active during CCP startup. However, the following 
programs must not be executing in that partition: 


@ User security data program ($CCPAU) 

@ Main storage dump to printer program ($CCPDD) 
® Assignment build program ($CCPAS)! 

@ Assignment list program ($CCPAL) 

@ Initialize assignment file build program ($CC1BF) 
® CCP ($CCP) 

® Any CCP generation stage program 


@ Any program that modifies programs or display formats that are used by CCP 
during its operation or that run under control of the CCP for this assignment set. 


The CRT/Keyboard, a card reader, or an online 3741 may be used to read OCL for the non- 
CCP partition. 


In addition to the messages issued during startup (see /BM System/3 CCP Messages Manual, 
GC21-5170), any one of the halts issued by the System/3 Model 15 may occur. The 
information needed to recover from these halts is provided in /BM System/3 Model 15 
System Messages, GC21-5076. If you take option 2 (controlled cancel) or 3 (immediate 
cancel) to a halt, that action is performed and CCP is terminated. Also, if the keyword 
CANCEL is used in response to startup messages SU011 or SU025, the CCP startup is 
terminated immediately. 


The CANCEL (CN) command can also be used to cancel the CCP partition. However, 
this statement is not allowed while disk files are being opened. 


The format of the startup message is: 
*SUnnnbbtext? 


where: 


. Indicates that the message or a group of messages requires a reply; otherwise the 


first character is blank. 


SU Indicates a startup message. 


lSccPas does not update $CCPFILE but provides diagnostics while CCP is in startup. 


Startup when more 
than one partition 
is active 


Options taken to Model 
15 halts 


Canceling CCP during 
startup 


Format of startup 
message 
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nnn Is a reference number used for clarification of the text that follows. 
#5 Separates the reference number from the text. 
text Is the startup message. 


? Indicates that CCP startup is waiting for your reply. After pressing the PF12 
key, you may enter YES, Y, NO, or N; enter a keyword; or press the ENTER key. 
The ENTER key can be pressed to retain the current information in all cases. 


A startup error message is indicated by *~ERROR*% as the first word of text fol- 
lowed by a blank and the remainder of the text. 


Startup Procedure 
Complete startup 1. Ensure that the disk packs containing disk files referred to by the OCL are 
procedure Online, unless the files are suppressed during startup. Also ensure that disk 
packs containing the object libraries in which display formats (if DEF is 
used) and CCP user programs reside are online. 
2: Enter the DELETE command if you do not wish to respond to | type 
messages (see /BM System/3 Model 15 Operator’s Guide, GC21-5075, fora 
description of IDELETE). 


3. Enter a SET command prior to loading CCP if you wish to override the 
Partition size specified during Model 15 generation. 


4. Enter the OCL statements to load $CCP. The OCL statements to be entered 
OCL statements from the system input device to the appropriate program partition are: 


OCL STATEMENTS 
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© ccpunit is the disk unit (R1, F1, R2, F2) on which the CCP production pack is 
mounted. 


@ filenam7 is the name of a disk file as actually referenced by a program running under 


the CCP. 1f symbolic files are used, this is the actual-name from the associated 
// DISKFILE assignment statement. 
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@ unitid is the disk unit (R1, R2,F1, F2,D1, D2, D3, or D4) on which the user file 
resides (or is being allocated), With a 3344, the following disk units are also 
valid: D31, D32, D33, D34, D41, D42, D43, and D44. 


@ packid is the disk pack name for the file. 


@ filenam2 is the actual filename on disk, specified when filenam1 is not the actual name 
on the disk. 


@ The maximum number of // FILE statements allowed is 40 for 5704-SC1, FILE statement 
and 192 for 5704-SC2. 


®@ No // FILE statement is entered for $CCPFILE or $CCPDUMP. 
@ An appropriate RETAIN parameter may be included on a // FILE statement. 


@ TRACKS, RECORDS, and LOCATION parameters may be included in the 
// FILE statements. 


If files to be loaded during the current CCP run are old files (built during a 
previous run), the LOCATION parameter and either the TRACKS or 
RECORDS parameter from the original OCL must be given to avoid creating 
a separate copy of the file. 


@ The CCP partition logs all messages to the CRT/Keyboard, regardless of where LOG statement 
the system log device has been assigned. If multiple partitions are active, the non- 
CCP partition may also log to the CRT/Keyboard. 


© A//BSCA statement may be required among the OCL statements used to load BSCA statement 
$CCP. This statement is used to change all BSCA line specifications in CCP to 
either line 1 or line 2, when one of the BSCA lines will not be available during 
CCP execution and the terminals for that line have been switched to the line 
that will be used. 


Note: Additional information about the OCL statements and OCC commands is 
contained in the following publications: 


@ /BM System/3 Model 15 System Control! Programming Reference Manual, 
GC21-5077 (for 5704-SC1) 


© /BM System/3 Model 15 System Control Programming Concepts and 
Reference Manual, GC21-5162 (for 5704-SC2) 


@ IBM System/3 Model 15 Operator’s Guide, GC21-5075 
The remainder of startup is a series of prompts, in message format, whereby you 


can make temporary changes to an assignment set. The complete procedure is 
given on the following pages. 
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Common startup Performing Startup—~No Changes Required 


procedure 
If you do not wish to make temporary changes to the current assignment set, you 


may perform the preceding startup procedure and, when CCP prompts the follow- 
ing message, press PF 12 and either key in NO or press the ENTER key: 


*SU011 ANY SPECIFICATIONS? 
CCP startup then issues the following messages (no response required): 
SU071 INITIALIZING CCP 


SU753 OPENING DISK FILES 
SU965 T/P BUFFER IS ****** BYTES, USER PROGRAM AREA IS ***K 


000 CCP STARTED 


14 


‘ON—JONVHO Se awes ayy s! 
spsomAay |e 18142 (HAIN Burssasd) Ajdas jn 


(uaaiB SpsomAay Ou 4! Ajdad {JNU 10 ON Se awes 
—sabueys 1ayiiny 105 ulefe asned you op ing ‘uanib 
spuomAay snoingid Aue 10} sanjea asn) ON—3ONVWHO 

(@pow sa}dwioid 0} LeAas ING 
‘uaaib Ajsnoiaaid sanjea asn) S3A—JONWHO 
(dOO s|#2Ued) FAONVO 
(OVENS sanss! dnjyze1s) INIT4AIO psom hay 
(OVENS PUe OOENS sanssi dnyeis) SSaYddNS 






yum 
rae } %21—s1g008a 4 pamole 
Bulssaid Aq papaoaid (ie sI'y ‘p40 ¢ saquinu au) J9s¢@ s1u) {yu} —oSaz0VUL anes 
aq isnw saBessaw dn (ue stv ‘Z 40 1 saquinu aut) yosa stu) {v|u} —dWwIW30VeL 20} 
-Jsb1S 01 SesUOdSAI ITY °“Z AMO: PAO AS? (ae AWAnoe d/1) dW IWAOVEL USeP ON 
: Aq ajqe|iene : (Seul| 1UdIdyJIP 10) Pareadas aq Ae, “We S! Y ‘Jequinu 
A1u0 ZOS-pOLS ase asauL aul g-| u6ip ajuis si u) { vy] u} —vLWaOVHL 
saquinu weibold “| (‘uo(1e13Ua6 Je UasoYo 4! 
“S810N pleA ‘“psomssed uo-ubls 49) 999999—QHOMSSWd 
(ease 4834NQ g/ 1 WNuIUIW) UUUUU~4N gd NIWA 
(ease Wes6Oid sasn WNnuwiuIl) yUU—WdaNNIW 
(4a19e4eYyo QI) 9-L]AS 
(A 711dd90$ 103 WUN)—LINA 
SSA 4alua ault sad ae au0 Jajug Y31LN3 Ssasd 10 'N ‘ON 
‘apouw Burduwoid Aq “spromAay Burmojjo} ay2 yO Aue 4a}ua ‘pabueyo aq 0} 
suoijeaiyioads abueys of Sutiajua Aq suonesijioads abueyd ase suoiieaiyisads ou 4] 


¢SNOILVOIFSIOAdS ANV LLONS« 
« = L3S LINVASA E00NS 


ON 






UN payoajas UO paubisse jas 1Neyap pijepA 


4 
@4 407 ‘LA 
“Ly Je1ua ‘3714d990$ ¥ALNG Ssaid ‘pasisap 
4Of 21UN Mau Ayloads OF si aBueys ou 4] paubisse jas 


yneyap pier 


ANIVA MAN Y34N3 ‘SONVHO O11 O90NS,. 





paubisse 10U 
yas TINeJap prjeA 






J3114d00$ YOd LINN ASIDAdS vOONS+ 


+» LINA NO 3114d990$ COONS 





y9ed wes6old uo 10U 44 14g90$ yoed weiboid “y 3114d0D$ Auy 
| 


dD E/WALSAS LOONS 









5 


1 


Startup and Shutdown 





@ 


| SBA Ja}ua 
"Jas Juawubisse Sry} UlYIM 
suoieoijioads }uswubisse abueys Of 






{ 49S 1deoxa) pasajua aq ued GZONS 
JaPUN Palsi} SPAOMASy BY] $O AUY 








ée LAS OL SAONVHO ANV SPONS. 


Aay YA LN $8830 “GEONS 
ut patyioads yas ay) asn OL 


pi ay) sdjua pue isi] ayy WOdy 
18S GY1 19a]aS ‘Jas JUdIaPIP CE aSN OY 









28 REDD) 
41SI17 WOdd OI 13S 19374S OvONns. 


q3sn... L4S ‘GAONVHO SS3INN SEONS 









Aq ajqe|teae \ 
aue asay | ) 





aul) sad psomAay 

auo sajuQ “uantB Ajsnoiaaid 
1OU 343M YDIYM Sp1omAay 
asauyi yo Aue Buriajua Aq 
sabueys juawubisse aye) 


S3A Ja1ua ‘apow 
Burdwod Aq sabueys 
luawubisse ayew OL 


éSAONVHD LNAWNOISSY AYVHOdWAL ANY SZONS 











GANDISSV LON 
13S 41NV4Aa0 OZONS 


é}UN palIa[as UO Paufisse jas 1]NeEyap PI|eA, 





Z410'7Y YALNZ ssaid 10 ‘Ny 
‘Ld ‘bd 492ua ‘3714d99$ ‘ON 4a1uU8 ‘paulsap 
40} UN Mau Ajloads OL si abueys Ou 3] 





ANIVA MAN ¥3LN3 SONVHO OL O9ONS. 


«+ LINA NO 3114d99$ ZOONS 








3114d90$ 6urusequos 
yun ay) yajas Aysnotaaid NOA pig 


(dOD sja9ues) TAONVD 


(OPENS sanss! dmiieis) JNIT4S4O psomAay 

(OPENS PUe OOENS sanss! dniseis) SS3HddNS nb 
bz pamo|e 

\%2 ~»79990Sa anjen 


(ne Si y ‘p 40 € daquinu aul] DOS@ §! YU) { 

(anes Alance d/1) dN TIW30VYEL 
(S@Ut| JUBIALJIP 10) Payeadas ao Ae) “WYWe Sty “Uequunu 

auty g-, 16Ip ayGurs e si uy) {w{u} —VLIWSOVYHL 
(uoije48UaB Ye UasOYD }I 

pea ‘psomssed uo-ubis 499) 999999-QYOMSSVd 

(ease 139}4NG g/} WNWiuiwW) YUvUU—4N Gd LNIW 

(ease Wesboud yasn WinuUIW) YUU—WdANIA 


ON 


410 
HON 


tess SY 0} 
1 


(SpsomAay INOYIIM 
4O Yim) Ajdas ||NN 





vlu}-oos@a0V¥L 40 (~) 
usep ON 





(4aye1eyo Ql) 9-13S 


roo 


apew aq 01 ae 


sabueyd yUuawuUbISse 


ou {t‘'N 40 ‘ON 


491U3 ‘YA INI SSd1g 






S3A 


16 





uuY JeUI0} YM SajAq jo Jaquunu ay) 4ajUua Y3LNQ ssid ‘pabueyoun uleluas 
“ease wesboud vasn Wwinuiuiw ay) abueyo of 0} St ease We16OJd Jasn ay) 4) 


OINNN) 3N1VA Y43..N] ‘W3YV WVY9OHUd 4YASN WAWINIW JONVHO OL SOLNS. 
4 


saiAq 40 Jaquiunu ay} JajuUa ‘ease YI3LN3 ssaid ‘pabueyoun uwiewas 
48jjNQ d/ | WNusUIW ay3 abUeYD Of O} St ease 4844NG d/ 1 ayr yf 









(S3LAQ) SNIVA Y3LN3 ‘W3IYV YH34IN8 d/L WNWINIW 3DNVHO OL OOLNS. 
AINNN = VaYV WVH9Odd Y3SN WAWINIW S60NS 
SALAG eeee% = VBHV Y3d4NSE d/L SINVNAG WNWINIW O60NS 





1 HILNJ ssasd 
Puomssed ay} Ja}uUa ‘pasn ‘pabueyoun uewa 


8q 0} Si psomssed mau e 4} O] SI psomssed ay) 4y 





SN IVA MAN Y3LN3 ‘3JONVHO O1 O90NS. 
/Paomssed, = GHOMSSVd GANDISSV SZONS 





17 


Startup and Shutdown 


dd9 ONIZITVILINI LZONS 


Galvo0o1lv 
3114 dWNdd39$ ON ,.ODNINYVM,,. 8P0NS 








31d dWNddd5N$ NI 
FTEVIIVAY ., GISN SdWNd ., 








LSONS 












3113 dNNadd0$ 
¥O4 031d103dS 
LINA GINIWANI 


ee LINO NO 311d dWNddd90$ 9P~ONS 
t 











osons 





03 05 


dQloo$ HLIM 
dWNGdDN$ AZIIVILINI 
- 311d dWNGd99$ GIIVANI 












6~0NS 





211} WNGdDO$ PHEA e 2! 


épasajua YUN pijeA 





épasaqua yun 


“H3LNG ssaid 
SI 911s HANGdDDS$ OU 4! 40 sailt 
dWNAdIDOF suseiuoo ey) yun 4a}Ug 


311d dNNGddN$ HOS LINN Adl03dS ZPONS, 


pauisap 





be. 


[inn G31d1939dS NO ONNO4 LON 37114 dNNGdDD$ ZS0NS 





ON [ SBA 


dijun paiyigads a2 UO ai!} dANMGdDD$ aul Ss 











ON SOA 





cuoleiuab Buiunp payeass alist dNNGdd0$ | 


on | 2X? 


guawaiers W3ZLSAS // 2U1 YO PIOMAIX LINAINNG aU} Aq palj!oads 11UN UO ally dWNGdII$ 














TE eRe Pe, wi aM seewOle.: Sc SA) b 


18 


(Peyeuiwsa} 

aq (IM dnueis) TGONVO 
(passaiddns aq ||1m 

Bununod isanbas) 1 NOWDd 

(1 euiw4ai)—VYyNIWdAL 

(8/2/9/S/b/€/7/L]-ANITVL IW 

[@/t]-3NI1Wvosa 

(aweu wesboid)—WY YOOud 

(aweu a yWwAs)—ATISWAS 

(aweUu ail}4sIp)—-ATt4aASIG 


LA aap spsomAay 
Buimoyfo} ay) sajue ‘bundwoid 
Ou 1Nq ‘pasisap uoissauddns 44 





‘passaiddns aq 0} swei601d 
jeuonippe moye 0} payeada: st abessayy ‘wesboid Y3.LN3 ssaud ‘ssasddns 0} sweshoud 
auo jO aweU ays sa}Ua ‘WesBold e ssaiddns 0} ayOw Ou aAey NOA UaUM 





G4SSAYddNS 38 OL IANWN WVH9OUd SOENS. 








“‘passaiddns aq 03 saweuayly 21jOqUAS 
Jeuonippe moje 0} pajyeadai si abessayy “aweuayly Y3LNJ ssaid ‘ssauddns 0} sayty 
ad1jOQwAs aUO sO aWeU ay) 43} Ua ‘ajty Be ssaaddns O] as0W Ou aAey NOA UayM 


(395 siyy ul aueUay!y D1|OqUAS 41 AjUO panss}) 
éG3SSAYddNS AG OL SNVN ATISWAS O€ENS. 





{ ‘passaiddns aq 0} | 
Sajly (EUOHIppe MoO]je 0} payeadas si abessayy “A1!) Y3LN3Z ssaid ‘ssaiddns 0} sajty 
jeoisAyd auo yo aweU ay) 1a}Ua ‘ajiy e ssaiddns Of 240 OU aAeYy NOA UBYM 


(288 siya ul Saqty 48IP 41 AjuO panss|) 
éGASS3UddNS 39 OL AWVN 3714 SIG OZENS. 





19 


Startup and Shutdown 






t YILNG ssaid 10 
*‘pajdwioud aq 0} Ysim NOA 41 SAA Ja1Ua ‘passaiddns aq 0} s1 JUNOD Isanbas ‘ON 491uU8 ‘pautsap 
wei6oid 30 ‘aut “peuruas ‘WesBord ‘aueualty IjOGWAS ‘a}ly 4SIP e 4] uotssaiddns ou 4{ 





éQG4SSauddNs 38 OL ALIMNIDV4 ANY OOENS. 











dO9 ONIZIIVILINI LZONS 


G34LHVLS ddd 000 


OINNN = Va¥V WYY9O0dd H3SN 
"SBLASG eevee = VAYV Y944NG d/l SIENS 





$3114 yNSIO ONINAdO ESZNS 
‘SATtdNsSI sl 


H31LN2 ssasd 
“aulyy4O BDe4d 0} syeuludsa} 


*JOUIUSIG) BY) JO Pr ay) 4a}UB ‘BUI;JJO jeUIWIa) e aoe|d OF 10 OU BAY NOA U3YAA 


ae 


Ql IWNINY3AL 3NINS3O ANV AdtD3dS OVENS. 








ON 40 {IAN 








(Waisds Ou! palesiauab }UNOD Jsanbas weshosd yt AjUO panss)) 
¢G3SS3YddNS 38 OL LNNOD 1S3NDIY WYHOONd SI S6ENS. 






“passasddns aq 01 s,qi 
yeutusal jeuontppe Moje 0} paieada, si a6essayy Y3ILN3J $sad ‘ssaiddns 02 syeurwal 
Pi }Butu4a) ay) iajUa ‘jeuiwisal e ssauddns of a10W Ou aney NOA UdyAA 


G3SS3uddNS 38 O1 GI TVNIWY3L SLENS. 





“passaiddns | 
9q 0} saul) jeuonppe moje O1 Payeadas si abessa-; YILN3@ SSaud ‘ssaiddns 0) sau 
“saquuNnu aut) ay) 4ajUa ‘aul] YL TW Ue Ssasddns of 210 OU aAeY NOA UayM 


(Q— 1 Saul) (29S siya Ul saul, YL IW 4! AjuO panss)) 
Q3SS3uddNS 38 OL YASWON 3NI1VLIW OSENS. 





PassaiGdns aq 0) Siayyng 44Q JeUuONIPpe MO]/e OF 
Ppayeadai si abessayy ‘passaiddns aq 01 (p 10 ‘€ ‘Z ‘t) Y3LNQ Ssaid ‘ssaiddns 07 


AIQUINU J344NQ 3Yyd Jayua ‘4say3Nq 44Q e ssaiddns of SOul} 3JOW OU BABY NOA UayMA 


(Passaaddns uaaq 10u aaey ‘p | Saul| ‘Saul DSg ay) 1/2 4) AjuO 
Pue yas siyd Ul SI 4M G44G 3! AUO ZONS-POLG Aq Panss;) 
GaASSIHddNS 34 OL HABWAN Y344NG 350 9GENS. 











“passaiddns 
aq 0} aul] Yea MOj;|2 0} Payeadas si abessay YSILN32 Ssasd ‘ssasddns 01 saul; 
“daQuNU Bul aur 4a}Ua ‘aul; YOSg eB ssaaddns of as0us OU aaey NOA Udy 


(p41 Saus)) Qas siya ul saun YOSg 4! AjuO panss;) 
G3SSAYddNS 39 OL H3SWNN 3NI1VvOSa SENS. 








20 


SHUTDOWN 


CCP shutdown begins when you enter the SHUTDOWN command. (See How to 
Stop the CCP System in Chapter 3.) CCP informs application programs that a 
SHUTDOWN command has been entered and the programs should terminate as 
soon as possible. Shutdown allows all application programs including CCP distrib- 
uted programs ($CCPCL, $CCPOP, and $CCPDD) that are currently running under 
the CCP to complete processing. Each application program should recognize the 
fact that CCP is shutting down and must perform the necessary termination action. 


Note: You may cancel CCP user programs individually after you have entered the 
shutdown command. See index entry canceling one program. 


Shutdown also allows queued programs to be initiated when other programs 
terminate and if the resources are available. The time required for the partition 

to complete processing after a SHUTDOWN command varies, depending on how 
many programs are executing, how many programs are on queue, and the number 
and size of indexed files that have had records added to them. You can learn what 
is happening during this time by using the display commands (see index entry) 

to determine the number of queued program requests, the programs still in use, 
and the terminals still in use. These and other system operator commands can be 
entered until the last user program has completed processing. At that time, shut- 
down begins its final processing and no additional input to CCP is allowed. 


Note: \f an online test is running when the SHUTDOWN command is entered, 
shutdown does not begin until data is entered on the terminal running the test. 


If CCP/Disk Sort is running when SHUTDOWN is entered, the sort continues 
executing until EJ. Ifa task chain sequence is running when SHUTDOWN is entered, 
all tasks in the sequence are allowed to execute until EJ. 


A shutdown delay feature, provided with 5704-SC2 only, allows the system 

operator to enter a time interval (in minutes) parameter with the SHUTDOWN 
command. The terminal operators are notified that a shutdown is pending, but the 
actual shutdown process does not begin until the specified time interval has elapsed. 
If the interval timer is not supported, a shutdown delay command will send the shut- 
down pending notice to the terminal operators. But the actual shutdown process 
will not begin until the system operator enters a SHUTDOWN command without a 
delay parameter. 


Cancel 


The cancel operation begins when you enter the CANCEL command. (See How to 
Cancel CCP, an Application Program, or Program Request in Chapter 3.) CCP 
cancel causes all user programs to immediately cease processing and causes CCP to 
go through shutdown. 


Shutdown 


Allowing programs to 
complete 


Waiting for EJ halt 


Cancel 


Not allowing programs 
to complete 
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Chapter 3. Controlling the CCP after Startup 


You control the system during the operational stage of the CCP. During its opera- 
tion you can do the following: 


® Enable/disable telecommunications lines and terminals. 

@ Initiate programs. 

@ Close and reopen disk files. 

@ Find programs and formats in the CCP object libraries (5704-SC2 only). 
®@ Reassign symbolic terminal names. 


@ Respond to specific messages on the console from command terminals, user 
programs, CCP, or system control program support routines. 


@ Request the status of the CCP, including: 

— Status of a specific terminal or of all terminals 

— Status of active and queued user programs 

— Allocation of resources for a program 

— Symbolic names and physical identifiers of terminals 
@ Request online terminal tests. 


@ Suspend and resume requests/execution/initiation of user programs. 


@ Shutdown CCP ina controlled manner: accepting no new program requests, but 
honoring completely all those accepted to this point. 


@ Schedule a CCP shutdown to begin after a specified interval of time has expired 
(5704-SC2 only). 


®@ Cancel a currently executing or queued application program. 


@ Cancel the system immediately; only the transmission of any messages currently 
being sent or received is completed. 


@ Send messages to a specific terminal or all terminals. 


@ Change interval polling times. 


® Activate or deactivate automatic retries to terminals in error recovery; also 
alter the time interval at which these retries are done (5704-SC2 only). 
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Initiate error recovery procedures for a terminal in CCP error recovery. 
Activate or deactivate TRACE facilities (56704-SC2 only). 

Build the $CCPDUMP file using program $CC1DP (5704-SC2 only). 

You can have multiple $CCPDUMP files but they must be on different packs. 
Keysort an indexed file at task termination (5704-SC2 only). 


Build, delete, and/or modify assignment sets using $CCPAS in another partition 
(5704-SC2 only). 


Notes: 
1. Modifications of the active CCP assignment set in $CCPFILE do not take 
effect until subsequent shutdown and startup. 
2. Modification of the active CCP assignment set in $CCPFILE will cause 
loss of current program request counts (if option was selected). 
s 


List assignment set using $CCPAL in another partition (5704-SC2 only). 


COMMANDS USED TO CONTROL THE CcP 


You can enter most commands in either full length versions or abbreviated versions. 
In some instances the commands require you to enter additional information. The 


commands are as follows: 


Command Abbreviation 
ASSIGN A 
AUTOERP AE 
CANCEL CN 
CLOSE — 
DISPLAY TERMID DBA 
DISPLAY TERMINALS DBT 
DISPLAY USERS DBU 
ERP - 
MSG M 
OPEN _ 
POLTIME PT 
RESUME RES 
SHUTDOWN i 
SUSPEND SUS 
TEST - 
TRACE E 
VARY Vv 


To enter a command, press the PF 10 key. When ENTER is displayed on the 


Description 


Assign a name to a terminal 

Control automatic error 
recovery facility (5704-SC2 
only) 

Cancel a program or CCP 

Close a BSCA line 

Display terminal assignment 

Display terminal status 

Display user program status 

Recover from a terminal’s error 

Send a message 

Open a BSCA line 

Change interval polling times 

Resume program(s) /initiation/ 
terminal commands 

Shutdown CCP 

Suspend program(s)/initiation/ 
terminal commands 

Perform an online test 

Enable/disable system trace 

Change a terminal’s status 


System operator 
commands 


Entering a command 


screen, enter the command. The entire command must be entered on a single line. 
Refer to Appendix B. Sample Commands for examples of the commands. 


The following pages explain each of the commands and describe how to issue 
them. The format of the commands are illustrated using the following conventions. 


@ Braces } indicate you must choose one of the entries. 


@ Brackets [ } indicate that the enclosed entry is optional. 


© Capitalized letters are to be entered exactly as shown. 


®@ Small letters represent information you must supply. 


@ Apostrophes must be entered when shown. 
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MSG (Message) command HOW TO SEND A MESSAGE TO A TERMINAL 


Use this command to send a message to a command terminal operator who is 
currently online but not under control of an application program. You must enter 
the command, the terminal identification, and the message to be sent on a single 
line. After you enter the command, the CCP informs you whether or not the 
message was sent. 


| Command =| | Additional Information 





\ MSG ( symbolic terminal name 
, Message text 
\ M ‘terminal physical 1D’ [a 
ALL EI 


i The name is defined during the CCP assignment run. 


The 2-character ID of the terminal is assigned during the CCP assignment. 


EZ The keyword ALL sends the same message to each online terminal that is 
available to receive messages. 


DISPLAY TERMINALS HOW TO DISPLAY THE STATUS OF TERMINALS 

command 
Use this command to tell the CCP to list status information about either a specific 
terminal/port! or about all terminals/ports! on the CCP system. Use this command 
to determine: 
@ The current operational status of terminals 
@ The names and 2-character |Ds of terminals 


@ Which task is controlling a terminal 


@ |f or when there appears to be a problem with a terminal 


| Command =| | Additional Information 





poise { TERMINALS. ( , terminal ID’ 
< \ symbolic terminal name i 
( D j | T \ blank 2 | 


Status information The CCP reacts to the command with status information about: 


i A specific terminal (specified by the terminal 1D or symbolic terminal name) 


fi All terminals defined to the CCP (second operand is blank) 


16704-SC2 only 
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The screen appears as follows: 


ID NAME MODE PROGRAM ' 
XXX SSSSSS Mmmm Q-pppppp WAIT OLT-ERP AUTOERP 


XXX SSSSSS mmmm PPPpppp 


SYSTEM STATUS 





XXX The 2-character terminal 1D or (5704-SC2 only) the 3-character 
port !D. The first position of the 3-character port ID indicates 
the type of port. The characters and their meanings are: 


SIOC port 

Task-to-task port 
BSCA line 1 port 
BSCA line 2 port 
BSCC line 1 port 
BSCC line 2 port 


PBwWN= 47 


The last two positions of the 3-character port ID indicate whether 
the port is acquirable (IDs 01 to 49) or nonacquirable (IDs 51 to 99). 


SSSSSS The symbolic name currently in use by the terminal. 


mmmm The operating mode of the terminal (see Appendix A. Glossary 
for definitions of the operating modes): 


CMD Command 
CMDI Command interrupt 


DATA Data 
INIT Initial 
STBY Standby 
OFF Offline 


15704-SC2 only 
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Default option prompt 


Printing the current 
display 


15704-SC2 only 
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pppppp The name of the user program that is currently in control of the 
Q-pppppp terminal. Q in front of the program name indicates the terminal 
is queued to a program for one of the following reasons: 


© The terminal is queued as a program requestor (has entered a 
/Q command) and is waiting for the necessary system resources 
to be allocated to the program: 

— Main storage to execute the program 

— An available task control block (If a task control block is 
not available, then the maximum number of CCP tasks 
established during system generation are currently 
executing.) 


@ The terminal is queued to a program that supports multiple 
requesting terminals (MRT program), but which is already 
supporting its maximum number. 


WAIT! TP buffer is required before the operation can be started. 
OLT-ERP An indicator of whether the terminal is in online test, error 
AUTOERP recovery or automatic error recovery. 


lf an unknown terminal !D or symbolic terminal name is entered with the command, 
the status information for all terminals will be displayed. 


The character in line 1, position 1 of the display (see Gi in the previous screen 
format) is a default option prompt. This character can be C, F, or R. The meaning 
of the prompt is: 


C — Cancel the display; cancel the DISPLAY TERMINALS command. 


F — Page forward to another display ‘‘page’’, because not all of the information 
could be contained in a single display. 


R — Return to, or repeat, the first page of the display. 


CCP displays a default option with each screen. You elect to use this option 
simply by pressing the ENTER key. If you want to select a different option, you 
must enter the appropriate character in place of the default prompt before 
pressing ENTER. 


In addition to the options described above, you can request a printout of the current 
display on the 1403 or 3284 printer by specifying P1403 or P3284, respectively. 


Note: Before entering P3284 or P1403, you must ensure that the printer is 
available. If the printer is already in use, its operation is interrupted and the 
screen contents are immediately printed. 


If you enter any character other than C, F, or R, or if you enter P without desig- 
nating a printer, the first page of the display is repeated. 


HOW TO DISPLAY THE TERMINAL ASSIGNMENTS 


Use this command to tell the CCP to list the symbolic name and terminal ID of a 
specified terminal/port’ or each terminal/port! defined to the system. The 


symbolic name is the currently active name (doing-business-as name) of the 
terminal/port!. 


You can use this command when you need to know to which terminal !D a name 
is currently assigned. For example, you can use this command before or after an 


ASSIGN command to change the terminal that is actually addressed by a specific 
symbolic name. 


| Command | | Additional Information 


(DISPLAY { TERMID { symbolic terminal name i 


\ D | BR a 2 |} 





The CCP reacts to this command with the name and corresponding ID of a specific 
terminal or of all terminals defined to the CCP, as follows: 


MM The 2-charactes terminal 1D or (5704-SC2 only) 3-character port |D and 


symbolic terminal name are displayed for the specific terminal named in 
the command. 


fa The 2-character terminal IDs or (5704-SC2 only) 3-character port IDs and 


symbolic terminal names of all terminals defined to the CCP system are 
displayed. 


15704-SC2 only 


DISPLAY TERMID 
(terminal assignment) 
command 


Currently assigned name 
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The screen appears as follows: 


ID NAME ID NAME 
xxx SSSSSS : 
xxx SSSSSS 
xxx ssssss* 


SYSTEM STATUS 





XXX The 2-character terminal 1D or (5704-SC2 only) the 3-character 
port ID. The first position of the 3-character port ID indicates 
the type of port as follows: 


SIOC port 

Task-to-task port 
BSCA line 1 port 
BSCA line 2 port 
BSCC line 1 port 
BSCC line 2 port 


BWN> +47 


The last two positions of the 3-character port ID indicate 
whether the port is acquirable (IDs 01 to 49) or nonacquirable 
(1Ds 51 to 99). 


SSSSSS The symbolic name associated with this terminal. 


An * following the symbolic name indicates that although this symbolic name is 
associated with this terminal, it is not the symbolic name that this terminal is 
currently doing business under. (See index entry doing-business-as name.) 


Line 1, position 1 of the display contains the default option prompt character—C, 
F, or R (see in the previous screen format). See the DISPLAY TERMINALS 
command for an explanation of the use of this screen position. 


HOW TO DISPLAY THE STATUS OF TASKS AND PROGRAMS 
DISPLAY USERS Use this command to cause the CCP to display the status of user tasks that are 


command currently active. You may also use this command to obtain information about a 
specific user task. 


| Command =| Additional Information 


“ DISPLAY ( USERS 
ye 2 ae 
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As a result of the DISPLAY USERS command, the CCP displays the following Primary screen format 


primary screen format: 


QO. TERMNL.PROGRM LOC SIZE STATUS 
CCPTRC.TBL-mm nnnK nnkK sss,sss,sss 
x-tttttt.pppppp nnnK nnk sss 
x-tttttt.pppppp nnnkK nnkK sss 


LARGEST FREE SPACE - nnnk? 


LARGEST UPA=nnnk? 


TP BUF=nnnnn,mmmmm 


SYSTEM STATUS 





The information displayed for each active task is: 


x Task ID 


CCPTRC.TBL-mm? Size of the trace table loaded in the UPA. CCP trace 
is active in the UPA. 


tttttt Name of the requesting terminal or, for 5704-SC2, the 
requesting program if loaded via a task chain request. 
Also, for 5704-SC2, the field may be blank if the 
program is in allocation or termination status. 


pppppp Name of the user program. 
LOC-nnnk Start address in main storage of the user program (physical 
address). 

SIZE-nnKk Amount of main storage required for th@user program. 
STATUS-sss The current operating status of the user program: 

AL In process of allocation 

TRM In process of termination 

SPD In a suspended state, as the result of a 

SUSPEND command 

QUE Queued to CCP, pending allocation 

ACT Active, running under the CCP 

Cccp? Tracing CCP entries only 

ALL? Tracing all trace entries 

DISK? Trace to disk is active 
LARGEST FREE The largest portion of the CCP user program area that is 
SPACE=nnnk? free for allocation to a user program. 


1 REQSTR for 5704-SC2 
25704-SC1 only 
35704-SC2 only 
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LARGEST UPA= The largest portion of the CCP user program area that 


annK! is free for allocation to a user program. 
TP BUF=nnnnn, The current free areas in the TP buffer: 
mmmmm! 

nnnnn - largest free block of buffer 


mmmmm - total of all free blocks of buffer 


If the CCP trace is active, information about the trace table size and location 


is displayed. ! 
Options to primary You may enter one of the following characters in line 1, position 1 of the primary 
screen screen format: 
C,F,R Same as the DISPLAY TERMINALS command. See 


that command for an explanation. 


3-9, E, G, H, V-Z This is a task ID, selected from the primary screen 


(5704-SC1) format. Entering a task ID causes the CCP to display a 
4-9, E,G,H, U-Z secondary screen format, containing more information 
(5704-SC2) about the specified task. If an invalid task ID is 


entered (for example, a task that has gone to end of 
job), the previous page is redisplayed. 


Secondary screen If a task ID is entered as a response to the primary screen format, a secondary 
format format is displayed, as follows: 


TASK-x NAME—tttttt.pppppp 


ATTR-NEP ,MRT (nn) ,DFF,NONE,SORT! CHAIN! 

U/R-uuuu, uuuu, uuuu 

TERMINALS-xxx,Ssssss,mmmm, WAIT), INVITE 
xxx ,SSSSSS ,mmmm 

DISK FILES-dddddddd ,dddddddd ,dddddddd, 


dddddddd 


SYSTEM STATUS 





'5704-SC2 only 
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The secondary display format contains the following information about the 
specified task: 


@ The task ID (x), requesting terminal’s name (tttttt), and user program name 
{(pppppp). For 5704-SC2, requesting program is displayed in place of requesting 
terminal if the user program was loaded via a task chain request. 


® Attributes of the user program: 
NEP Never-ending program (see Appendix A. Glossary for a definition). 


MRT(nn) Multiple requesting terminal program (see Appendix A. Glossary). 
nn = The maximum number of concurrent requesters the program 
can handle. 


DFF 3270 Display Format Facility used by the program (see index entry 
display format facility). 


SORT CCP/Disk Sort Program. 
CHAIN Program was requested via a chain task request. 


NONE None of the preceding attributes apply. 


@ Device name of each unit record device allocated to the program where uuuu is 
the name of a unit record device; otherwise, NONE if no unit record device is 
allocated. 


@ Information about each terminal allocated to the program (NONE, if no terminals 
are allocated): 


XXX two-character terminal !D or (5704-SC2 only) 3-character 
port 1D. The first position of the 3-character port ID 
indicates the type of port as follows: 


SIOC port 

Task-to-task port 
BSCA line 1 port 
BSCA line 2 port 
BSCC line 1 port 
BSCC line 2 port 


BWN= 47 


The last two positions of the 3-character port 1D indicate whether 
the port is acquirable (1Ds 0 to 49) or nonacquirable (IDs 51 to 99). 


SSSSSS symbolic terminal name 


mmmm operating mode (DATA—data mode; CMD!—command interrupt 
mode) 
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Options to secondary 
display 


Special messages 


15704-SC2 only 
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WAIT! TP buffer is required before the operation can be started. 


INVITE displayed if input is scheduled from the terminal 


@ File label on disk (dddddddd) of each disk file required by the program (not 
necessarily the file name used in the program). 


You may enter one of the characters C, F, or R in line 1, position 1 of the display. 
CCP displays a default prompt which you can select by pressing the ENTER key. 
The display options are explained under the index entry display terminals command. 


CCP displays one of the following messages when the requested display cannot be 


prepared: 


CCP NOT ACTIVE 


NO TASKS ACTIVE 


TASK IN 
ALLOCATION 


TASK IN 
TERMINATION 


Issued in response to the DISPLAY USERS command when 
shutdown has cleared all user tasks. Any response you 
make cancels the command. 


Issued in response to the DISPLAY USERS command when 
CCP is running, but there are no active tasks. Enter C in 
line 1, position 1 to cancel the command. Any other entry 
redisplays the message. 


Note: You may want to use the DISPLAY USERS com- 
mand, even when no tasks are active, to determine the size 


of the user program area. 


The specified task is in an allocation stage; information 
about it cannot be displayed at this time. Your options are: 


C Cancel the display 
R_ Return to the primary display 


Any other entry causes this message to be displayed again. 
The specified task is in a termination stage; information 
about it cannot be displayed at this time. Your options 


are: 


C Cancel the display 
R_ Return to the primary display 


Any other entry causes this message to be displayed again. 


Note: \f an 1/O error occurs while the file labels part of the display is being prepared, 
the message //O ERROR appears in the disk label line and the display is shown as 


it exists at that time. 


HOW TO SUSPEND REQUESTS/EXECUTION/INITIATION OF PROGRAMS 
Use this command to: SUSPEND command 
@ Suspend execution of all application programs. 


@ Suspend execution of one application program. 


@ Prevent initiation of additional application programs or, for 5704-SC2, prevent 
initiation of a particular application program. 


@ Prevent accepting commands from termina! operators. 


| Command | | Additional tnformation 


‘SUSPEND USERS 
task 1D, program name | 
INIT [,program name] 3 | 
| COMMANDS go 


i Suspends the processing of all application programs and prevents new pro- Suspend all programs 
grams from being initiated. This command could be used if CCP appears to 
be malfunctioning and you want to suspend operations to examine the 
system status. The display users, display terminals, or display terminal ID 
commands can be used to examine the system status. 













Suspends a particular application program when that program appears to be Suspend one program 
holding control of the system or otherwise malfunctioning. 


Prevents initiation of further requests for application programs. Programs that Prevent program 
are on queue waiting for main storage or an available task control block remain initiation 

on queue. Programs that are on queue waiting for other resources wil! execute 

when those resources become available. This command can be used to prevent 

a program(s) from being initiated but to still allow terminal operators to enter 

commands. Under 5704-SC2 only, an individual program initiation can be 

suspended if changes are being made to it or to its files. 


Z¥ a. Prevents terminal Operators from entering commands when their terminal Prevent terminal 
is in initial or command mode. Command interrupt mode terminals are commands 
allowed to enter commands. 


b. Prevents the console operator from entering terminal-type commands 
(/Q, /NOOQ, /FILE). 


If the last executing user program is terminated by your issuing the CANCEL 
command while the SUSPEND USERS command is in effect, the SUSPEND 
USERS command is automatically cleared by program termination. However, the 


SUSPEND INIT command is still in effect and must be cleared via the RESUME 
INIT command. 


Care should be used when suspending programs that are currently communicating Use caution suspending 
over a BSCA line. If resumption does not occur within a specific period of time program on BSCA line 
(specified during assignment on the BSCALINE statement or the maximum delay 

count specified for the terminal, whichever is less), a T/P error may occur 

preventing further communication by the program using that line. This program 

must then be terminated or issue its own error retry to resume execution. 
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HOW TO RESUME REQUESTS/EXECUTION/INITIATION OF PROGRAMS 
RESUME command When a SUSPEND command has previously been issued, use a RESUME command to: 
@ Resume execution of all application programs. 
@ Resume execution of one application program. 


@ Permit initiation of additional application programs or, for 5704-SC2, permit 
initiation of a particular application program. 


@ Permit accepting commands from terminal operators. 


| Command || Additional Information 


( RESUME | USERS LV 


task ID, program name ra 
\ RES \ INIT [,program name] El 
g COMMANDS 





Resume all programs i Resume execution of all suspended application programs and allow new 
program requests to be initiated. 


Note: \f botha SUSPEND USERS command and aSUSPEND INIT command 
have been entered, the RESUME command negates both of those commands, 
but not the SUSPEND INIT,progname command. 


Resume one program 2 | Resume execution of one particular suspended application program. 


Allow program initiation EX Aliows program initiation to resume. However, if aSUSPEND USERS 
command is in effect, you must either: 


@ Specifically resume or cancel each suspended program, or 
@ Enter a RESUME USERS command. 
Otherwise a RESUME INIT command will be rejected by CCP. 


Program 5704-SC2 allows initiation of a particular application program to 


resume. 
Permit terminal Z¥ Permits all command-capabie terminals not currently in use by an application 
commands program to enter commands or program requests. 
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HOW TO CHANGE THE INTERVAL POLLING TIME 


Use this command to change: POLTIME command 
®@ The number of seconds that CCP polls terminals continuously (upon negative 


response) before entering a wait state if interval polling is generated into the CCP 
system. 


@ The number of seconds to wait before repolling. 


| Command | Additional information 


POLTIME a ( | 3 | .BSCA 
(PT) 


BA lno § 


ttt is the time in seconds to poll continuously before initiating interval polling. 
ww is the time in seconds to wait before repolling. 










»BSCC 





NO, the default, cancels interval polling. 


E} BSCA or BSCC specifies if time should apply to BSCA lines 1 and 2 or to 
BSCC lines 3 and 4. 
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HOW TO CHANGE THE STATUS OF A TERMINAL 


VARY command Use this command to change the status of a terminal from online to offline or from 
offline to online. The CCP sends a message informing the termina! operator of the 
change in status of the terminal. This message is sent only to command-capable 
terminals on a nonswitched line. The message is never sent to CPUs. The CCP 
does not accept this command if the terminal is under control of an application 
program. 


If a non-command-capable terminal is online, it is available for use by application 
programs. If it is offline, it is not available for use. CCP does not communicate 
with an online, non-command-capable terminal except at the direction of an 
application program. 


If a command-capable terminal is online and not currently being used by an appli- 


cation program, CCP allows input from that terminal. If the terminal is offline, 
input is not allowed nor is the terminal available for use by an application program. 


| command |_| Additional Information 


VARY Ta 


1 Specifies the terminal (or all terminals on a line) to be placed online or offline. 






symbolic terminal name 1 | 


‘terminal ID’ OFF ( Ky 





LINE 


PWN > 


MLINE 


AN Oa hPWN 





The specified terminal is placed online. The terminal is enabled for initial 
mode input if it is capable of entering commands. Use ON when a terminal 
is offline and you want to allow communication with it. 


ka The LINEn operand applies to BSC lines only. For MLTA lines, use the 
MLINEn operand. 


og The specified terminal is placed offline. Communication with the terminal 
is terminated. In addition, if the terminal is on a switched line, the line is 
disconnected; if there are any online command terminals on the switched 
line, the line is re-enabled to allow a terminal to call in. 
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If a vary offline is issued to a command-capable terminal, the processing of the 
terminal to offline status begins with an attempt to stop any outstanding invite 
input operations previously issued by CCP to the terminal. Offline processing 
completes only when the invite input request is canceled or the input operation is 
completed. For certain terminals, the hardware makes it difficult to stop the invite 
input operation. For the following terminals, the terminal remains in the process of 
being varied offline until the input operation completes: 


2741 Basic 

2741D Dial 

2740DT Dial with Transmit Control Feature 

2740DTC Dial with Transmit Controt and Longitudinal Redundancy Checking 
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HOW TO CHANGE THE NAME OF A TERMINAL 


ASSIGN command Use this command to assign another symbolic terminal name to a terminal. The 
newly assigned name must be taken from the group of terminal names defined in 

Assign alternate the current assignment set (TERMNAME statements) that either are not assigned 

terminal to a specific terminal or are assigned to a like terminal. You can use this command 


to assign an alternate terminal when a particular terminal is inoperative. 


Doing-business-as If the terminal is a data terminal, the new name becomes the doing-business-as 
name name of the terminal. If the terminal is a command terminal in command mode, 
the new name becomes an available name that can be used to refer to the terminal. 
The doing-business-as name is controlled by the terminal operator's use of the name 
command (see /BM System/3 CCP Terminal Operator’s Guide, GC21-7580). 
When the terminal operator uses a name command to change the doing- 
business-as name of the terminal, CCP prints a message on the console informing 
you of the name change. 


Note. \f the specified terminal is a command terminal in initial mode, the new 
name becomes the doing-business-as name of the terminal, as with a data terminal. 
However, if the terminal operator signs on the command terminal, the doing- 
business-as name reverts to the original name. 


| Command | Additional Information 


ASSIGN “i 


A terminal can be referenced by one or more symbolic names. This command 
does not cancel any symbolic names; it provides an additional name that can 
be used to reference a terminal. 





symbolic Soon name, ‘terminal [,stt index aad 






Note: \f the last assigned name of an offline terminal is reassigned while that 
terminal is offline, a name must be assigned to that terminal before it is 
varied online. 


2 | This command is rejected if you try to assign a name to different types of 
terminals. For example, you cannot assign a symbolic name to a BSCA 
terminal if the same name is being used by an MLTA terminal. Examples of 
invalid combinations are: 


MLTAterminal . . . . . . . ). >. BSCA terminal 

Switched line terminal . . . . = . = . =. Nonswitched line terminal 

1050. . . . . . . 2 2...) ~Non-1050 

3270M1* (3277M1 or 3275M1). . . . 3270M2* (3277M2, 3275M2, 
or 328x printer) 

S200) & F> S  ee a’ Bh o ke a & he BIS 

CPU ec Mee a he ee (3270 


*M1 (small screen), M2 (large screen) 


Telephone number El = The STT (Switched Terminal Table) index number is used to change telephone 
numbers for terminals on a switched line. Each STT index number refers to a 
telephone number defined during assignment. See the output from the 
assignment list program to determine which STT index number to use. 


HOW TO RECOVER FROM TERMINAL ERRORS 


Use this command to tetl the CCP what additional error recovery procedures to ERP command 
take when a terminal is in CCP error recovery. 


Your action depends on whether or not the terminal is under control of an applica- 
tion program. If the terminal is under control of an application program, you will 
receive a message issued by the 1OCS and CCP indicating the application program 
has the responsibility of determining what action to take. If the terminal is not 
under control of an application program, you will receive an IOCS message and a 
message from the CCP indicating you may take some action. You can respond to 
the CCP message using this command. 


Command Additional Information 





ERP ‘terminal ID’ “RETRY & 


al ‘Bypass El 


1 
2 
3 
4 


1 
2 
3 
4 
5 
6 
7 
8 





EB Teils the CCP to reissue the failing operation to the terminal. If the failing Reissue failing operation 
operation was on input, then the message S12 TP ERROR ON INPUT is sent 
to the terminal by CCP before the failing operation is reissued. If the LINEx 


operand is used, all terminals on the line are affected if they are in error 
recovery. 


| 2 | Tells the CCP to proceed to the next operation and bypass the failing opera- Bypass failing operation 
tion. If the failing operation was on input, then the message $12 TP ERROR 
ON INPUT is sent to the terminal by CCP before continuing with the next 
operation. 


| 3 | The LINEn operand applies to BSC lines only. For MLTA lines, use the 
MLINEn operand. 


Whenever CCP detects that an error occurred while communicating with a terminal, 
a message is displayed at the console informing you of the error. In addition, if the 
terminal does not currently belong to an application program, the terminal is 
placed in CCP error recovery. You are informed of this with the message: 


416 ‘xx’ IN CCP ERROR RECOVERY 
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While in CCP error recovery, no input or output data transfer is allowed to the 
terminal. Therefore, there can be no communication to or from the terminal until 
you respond to the error condition. 


Responding to error If you do not wish to attempt error recovery, you may: 
conditions 
1. Issue a vary command to place the terminal offline. 
2. Issue a test command to initiate an online test to the terminal to further 


analyze the error condition at the terminal (see How to Perform System 
Operator Initiated MLTA Online Tests). 


If CCP is the calling station on a switched line (auto or manual) and the remote 
station (called terminal) disconnects the line without sending the disconnect 
sequence, the CCP connection with the line remains intact. Error recovery attempts 
under CCP will result in the following message until the line connection to CCP is 
broken: 


411 [INPUT/OUTPUT] ERROR-10 ON’xx’ 


It is suggested that after three such retries the line be disconnected from CCP and 
a new connection be established with the terminal. 


HOW TO CONTROL THE AUTOMATIC ERROR RECOVERY FACILITY (5704-SC2 ONLY) 
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Use this command to activate or deactivate automatic error recovery procedures or 
to change the time interval at which such procedures are performed. 


Certain terminals in the current assignment set may be defined as supporting the 
automatic error recovery facility. CCP provides automatic error recovery procedures 
for those terminals whenever the facility is active and such a terminal is in error 
recovery. You can use this command to control the recovery procedures performed 
at those terminals by CCP. 





Additional Information 


Command 
eee ON 7 ee 3 | 
AE ort 


1 | Tells CCP to activate automatic error recovery procedures for those 
terminals that support the facility. 



















B Deactivates the facility. 


El nn is a one- or two-digit decimal number that specifies, in minutes, 
the time interval at which error recovery procedures are to be executed. 


This command will not be accepted by CCP after a SHUTDOWN command has 
been accepted. 


HOW TO SAVE TRACE TABLE INFORMATION 


Use this command to: TRACE command 
®@ Enable or disable DSM system trace. 


@ Turn on the in-storage MLTA/BSCA/BSCC trace. If the MLTA, BSCA, or BSCC 
IOCS detects a permanent error on a T/P line while the MLTA, BSCA, or BSCC 
trace is on, the contents of the in-storage trace table are written to the system 
printer. 


@ Turn on the CCP trace. The CCP trace entries are the same as those produced 
by $TRACE for TYPE-CCP or TYPE-ALL. The CCP trace module is loaded 
into the UPA via an operator command under CCP. The 4K trace module and 
the trace table reside in the UPA for the duration of the tracing activity. When 
CCP trace is terminated, the main storage occupied by trace in the UPA is 


released. 
This command may be used when there are hardware or program problems and you Solve hardware or 
or the IBM customer engineer are attempting to solve the problem. When MLTA/ program problems 


BSCA/BSCC trace is active and spool is also active, the spool task must be a 
lower priority than CCP. If spool was a higher priority it would not gain control 
after a snap dump was printed. 


| Command | Additional Information 

















(URACE) (ON | a SYSTEM 
| a. 3 lore | 2 | ae 
,BSCC 











ccp ee Fal g 
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1 | ON activates the appropriate trace. 


2 | OFF turns off the appropriate trace. 


3 | Specifies which one of the traces you want to turn on. In order to specify 
TRACE ON for MLTA, BSCA, and/or BSCC, you must have specified 
TRACEMLTA, TRACEMLMP, and/or TRACEBSCC keywords during startup, 
in response to startup message SU011, SU025, or SU045 (see startup proce- 
dure in Chapter 2). 


a 


15704-SC2 only 


Controlling the CCP after Startup 43 


go Specifies that CCP trace functions will be initiated: 


ALL indicates that the trace TYPE-ALL will be used 


Cccp indicates that the trace TYPE-CCP will be used 
nn is the size of the trace table in K bytes; it ranges from 


04 to 32 in 4K increments 
DISK _ indicates that the trace to the CCP dump file 
(SCCPDUMP) will be used 


When turning trace OFF, it is not necessary to specify the table size or DISK 
operand. 


HOW TO PERFORM SYSTEM OPERATOR INITIATED MLTA ONLINE TESTS 


TEST command — Use this command to initiate an MLTA terminal online test. If a terminal operator 
MLTA terminal tests for suspects that his terminal is not operating correctly, he can ask you to initiate an 
1050, 2740/2741, and MLTA terminal online test. When starting a test, you must specify that either all 
CMCST tests are to be runor a specific test number is to be run. After the test, the terminal 


Operator can compare the actual results with the correct test data to identify the 
problem. See Appendix D. Online Tests for a description of the tests. 


| Command | Additional Information 





TEST ( symbolic terminal mek ( n a) 
-. AL |.o0® o| 
( ‘terminal ID’ j | ‘stop EM) 


Specifies the test number to be run (n = 2 through 6). 


MLTA test number 


All MLTA tests 


Indicates that all tests for a particular terminal are to be run. 


Stop MLTA test Tells the CCP to stop a looping test currently being run on the specified 


terminal. 


Run MLTA test Indicates that the test for the particular terminal is to be run continuously, 

continuously until another TEST command is entered specifying stop. If loop is specified, 
only a single test may be run (ALL is not valid). An error on the terminal will 
stop any online test including a jooping test. 


Note: The MLTA online test can only be initiated to a command terminal that is 
signed on and not in communication with an application program; that is, the 
terminal is either in command mode or command interrupt mode. (See Appendix 
A. Glossary for definitions of these terms.) 


HOW TO PERFORM SYSTEM OPERATOR INITIATED BSC ONLINE TESTS 


Use this command to initiate a BSC online test to another CPU. When starting a 
test, you must specify the test number, the message, and the number of times you 
want the message to be repeated. See Appendix D. Online Tests for a description 
of the tests. 


| Command || Additional Information 


TEST command— 
BSCA/BSCC CPU 





TEST \ symbolic terminal ne | \ 
Vereen ID’ ‘) 


i Specifies the test number to be run. The valid entries for n are O, 1, 6, or 14. 


PE The number of times the message Is to be transmitted or received. The valid 
entries for cc are 01 through 99. 


El The message text to be transmitted for test O or received for test 1. 


Note: The entire TEST command, including the message, must be entered on a 
single line. 


When performing these tests (which can run only to CPUs), you must assume that 
the program on the remote CPU handles the 0, 1, 6, or 14 online tests. 


Notes: 

1. When CCP is the control station, only test 0 is valid for the CPU tributaries. 

2. The test message may not contain commas or embedded blanks. 

3. The BSC online test can be initiated only to a command terminal that is 
signed-on and not in communication with an application program; that is, 
the terminal must either be in command mode or command interrupt mode. 
(See Appendix A. Glossary for definitions of these terms.) 


BSC test number 


BSC message 
transmitted 


BSC message test 
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HOW TO PERFORM A SYSTEM OPERATOR INITIATED BSCC WRAP TEST 


Use this command to initiate a wrap test of the BSCC attachment when problems 
are occurring on line 3 or line 4. This test does not include the interface cables. 


| Command | | Additional Information 


TEST LINES 


& Specifies the BSCC line attachment on which the test should be run. You 
must enter either LINE3 or LINE4; there is no default. 





After the test is performed, a message giving the test results is displayed on the 
system operator’s console. 


If the wrap test is successful, the cause of the problem is probably in the tele- 
processing line, the interface cable, or the modem(s) and not in the BSCC. If the 
test is unsuccessful, the problem is in the BSCC; contact IBM for hardware support. 


Wrap Test Results 


A message with the following format is sent to the system operator console to 
report the results of a wrap test: 


1B YT xx | 


TEST OF Line} ; twas \ SeaeSe UE 


4 UNSUCCESSFUL J 


DATA FIELD STATUS = zzzz 


where: 
XX is OO for a successful test or 
10 for an unsuccessful test 
Zzzz is 0002 for a successful test or a four-digit value indicating the reason 


for failure if the test was unsuccessful. These codes are described in the 
1BM System/3 CCP Data Areas and Diagnostic Aids, SY21-0040. 


HOW TO CLOSE OR OPEN A BSCA LINE 


Use this command to close a BSCA line under CCP and make it available to another 
partition, or to reopen a BSCA line under CCP that was previously closed by the 
CLOSE command. 


To Close a BSCA Line 


Prior to closing the line, you must successfully VARY the line off. Close the line CLOSE command 
by entering the commands in the following sequence and format (where n is 1 or 2): 


Additional Information 





VARY b LINE" OFF 
CLOSE b LINEN 


To Open a BSCA Line 


Once the OPEN command is completed, you must VARY the line on before pro- OPEN command 
cessing on the line can begin. Open the line by entering the commands in the 
following format (where n is 1 or 2): 


} command — | | Additional Information 


OPEN b LINEN 
VARY 6 








LINE",ON 
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CANCEL command 


Cancel CCP 


Canceling one program 


Dumping a canceled 
program 
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HOW TO CANCEL CCP, AN APPLICATION PROGRAM, OR PROGRAM REQUEST 
Use this command only when the CCP or an application program (user task) appears 
to be malfunctioning, or when you wish to cancel a queued program request. 

To Cancel CCP or an Application Program 


Enter a command in the following format to (1) immediately terminate CCP and 
all CCP user tasks or (2) immediately terminate a particular CCP user task. 


| Command — || Additional Information 


“CANCEL i 
ccP ie name] <r 
Immediately stops processing of all application programs; the CCP then ter- 
minates itself by performing a controlled cancel. 









Immediately stops all processing for one program and frees the resources 
allocated to it. Some application programs allow multiple copies of the 
program to reside in main storage at the same time. Therefore, you must 
enter the task 1D and the program name to cancel the correct application 
program task. You may have to issue the DISPLAY USERS command to 
determine the task ID and the program name prior to issuing this command. 


El When you are canceling CCP or a specific program, you can specify that a 
main storage dump of the canceled program be written in $CCPFILE 
(SCCPDUMP for program number 5704-SC2). 


When you cancel a specific program, all disk files open for the program are pseudo- 
closed by CCP. They are not finally closed by the system control program until 
either the SHUTDOWN command or the CANCEL CCP command are entered. 
CCP cancels all pending communications !/O operations prior to terminating a 
program. 


Notes: 

1. CCP distributed programs (SCCPCL, $CCPOP, $CCPDD) that begin with a $ sign 
cannot be cancelled once they are executing. An attempt to cancel a $ program 
name results in an invalid name message. 

2. |f anumber of programs are queued for execution or a large indexed file has had 
records added to it (causing a key sort), a significant amount of time may elapse 
between the CANCEL CCP command and end of job for CCP. 

3. If another partition is trying to open/close a file and an error occurs, CANCEL 
waits until that error is responded to before trying to close CCP files. 

4. CCP distributed program $HACCP can be called from the system console only. 


To Cancel a Queued Program Request 


In certain situations, you can cancel a program request that has been queued by Canceling a queued 
CCP. The program request may have been made either by you or by a terminal request 

operator. In order to determine whether a queued request can be canceled, proceed 

as follows: 

1. Issue a DISPLAY USERS command to determine the task ID and status of 


the requested program. If the program request has been queued either 
because a terminal is temporarily unavailable or because of contention with 
another program for a nonsharable disk file, the program’s status will be AL 
(awaiting allocation). You can then issue a CANCEL command in the follow- 
ing form to cancel the queued request: 


| Command || Additional Information 


( CANCEL ° 
Len 


2. If the DISPLAY USERS command does not show the status of the program, 
issuea DISPLAY TERMINALS command to determine if the program request 
has been queued (indicated by a Q preceding the program name) for one of 
the following reasons: 





CCP,task ID,program name 


@ If there is currently insufficient space in the user program area to load the 
program 


@ If the maximum number of tasks established during the generation of your 
CCP system are already running. 


In either of these cases, you can cancel the request by entering a CANCEL 
command in the following form: 


| Command | | Additional Information 


| CANCEL \ 
cn J 


The DISPLAY TERMINALS command will also show a Q preceding the 
program name when the request is for a program that supports multiple 
requesting terminals (MRT program) but is already handling the maximum 
number of requesters. In this case, however, the request cannot be canceled. 






CCP,0,terminal ID 


Note: Remember that the program execution environment under CCP is 
dynamic; therefore, it may be necessary to repeat the DISPLAY commands 
to get the current status. For example, a program’s status may change from 
queued to active. 
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HOW TO CLOSE A DISK FILE 
Use this facility when included in the current assignment set to: 
@ Prevent the allocation or queueing of program requests that use a particular file. 
@ Merge added records with the original records of an add file. 


To close a disk file, first press the PF9 key. When you are prompted, press PF12 
and enter the close request in the following form: 


Hi Additional Information 


filename a 





Program 


SCCPCL 











1 Specifies the name of the file to be closed (the NAME parameter on the CCP 
startup OCL // FILE statement). 


If the file is not currently in use, it is marked closed and is unavailable to programs 
running under CCP. Another partition, if it exists, is able to process the file, includ- 
ing records previously added by CCP programs. A non-CCP partition cannot add to 
this file. A message to the system operator indicates if the file is currently used by 
the system control program or CCP. Then $CCPCL goes to EJ. For multivolume 
files, all volumes will be closed. 


Note: In order to utilize this facility, program $CCPCL must be included in the 
current assignment set. (See the description of the NAME parameter for the 


PROGRAM assignment statement in /BM System/3 Model 15 CCP System 
Reference Manual, GC21-7620.) 


HOW TO REOPEN A DISK FILE 


Use this facility when included in the current assignment set to allow the allocation 
and queueing of program requests which require a previously closed file. 


To reopen a disk file, first press the PF9 key. When you are prompted, press PF12 
and enter the open request in the following form: 


[roe 
$CCPOP 6 


a Specifies the name of the file to be reopened (the NAME parameter on the 
CCP startup OCL // FILE statement). 

















Additional Information 






filename 


Note: \n order to utilize this facility, program $CCPOP must be included in the 
current assignment set. (See the description of the NAME parameter for the 


PROGRAM assignment statement in /BM System/3 Model 15 CCP System Reference 
Manual, GC21-7620.) 


HOW TO FIND A DFF FORMAT (5704-SC2 ONLY) 


Use this facility when a new or modified DEF format has been cataloged to the DFF 
pack to: 


@ Update DFFSFDT (Function 1). 
@ Find the format for future use (Function 2). 
®@ Both of the above (Function 3). 


To find a DFF format, press the PF9 key. When you receive a prompt from the 
system, press the PF12 key and enter your request in the following format. 


Function Program Additional Information 





1 CCPFEMT prog-n[,prog-n] ... [,prog-n] 
2 CCPFMT $Zname[,$Zname] ... [,$Zname] 


3 CCPFMT $Zname, prog-n... 





where: 
prog = program name 
n = DFFSFDT value? 
$Zname = DFF format name in the object library 


Note: The numbers listed under Function identify the functions previously 
mentioned; they are not entries. 


Normally, the result of action by CCPFMT to update DFFSFDT values in an 
assignment set in $CCPFILE will remain in effect until the assignment set is 
recompiled, or until! CCPFMT is run to change those values again. In the case of 
5704-SC2, an exception results when a currently executing assignment set is 
replaced or deleted while CCP is in operation. This exception is that the update of 
DFFSFDT values by CCPFMT is effective only for the current execution of CCP 
(until shutdown). 


: Described under PROGRAM assignment statement in the /BM System/3 Model 15 CCP System 
Reference Manual, GC21-7620, or under format find routine in the /BM System/3 CCP Programmer's 
Reference Manual, GC21-7579. 
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HOW TO FIND A PROGRAM (5704-SC2 ONLY) 


Use this facility when EXECFIND or PGMFIND programs have been revised and 
are permanently cataloged to a CCP-accessible pack. This facility allows future 
requests for those programs to be handled as efficiently as possible, and allows 
application programs to be revised. 


To find a program, press the PF9 key. When you receive a prompt from the system, 
press the PF 12 key and enter your request in one of the following formats: 


CCPPGM namel[,name. . .,.name] 
or 

CCPPGM name-unit[,name-unit. . .,.name-unit] 
or 

CCPPGM name[,name-unit].... 


where: 
name = program name 
unit = unit that contains the program: 


PROGRAM, SYSTEM, P, S, 
R1, F1, R2, F2, 
D1A, D1B, D1C, D1D, D2A, D2B, D2C, D2D, 
D3A, D3B, D3C, D3D, D3E, D3F, D3G, D3H, 
D4A, D4B, D4C, D4D, D4E, D4F, D4G, D4H 
CCPPGM name finds the program on the pack from which it is currently loaded. 


CCPPGM name-unit finds the program on the specified pack. 


HOW TO STOP THE CCP SYSTEM 


SHUTDOWN command This command tells CCP to terminate after the application programs have completed 
processing and, if used, after the optional delay time has expired. 


Additional Information 


For 5704-SC2, a time value entered with the SHUTDOWN command causes the 
start of shutdown execution to be delayed from 1-99 minutes (a time value of 0 is 
invalid). 










1The source for the assignment set will now logically differ with the contents of the set on 
$CCPFILE. A program found by CCPPGM will remain defined as EXECFIND-NO on $CCPFILE 
until the assignment set is replaced with another assignment build of the set. An exception to this 
results when a currently executing assignment set is replaced or deleted while CCP is in operation. 
In this case, the action of CCPPGM in converting EXECFIND-YES programs to EXECFIND-NO 
programs is only in effect for the current execution of CCP {until shutdown). 
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When the command has been accepted, CCP will not accept commands or program 
requests from terminal operators unless the terminal is in command interrupt mode. 
All currently running programs are notified about the shutdown and allowed to com- 
plete processing unless you cancel them. Any programs that are on queue are loaded 
and processed when resources become available. 


It is the responsibility of each application program to recognize that a shutdown 
indication has been given to it after the command has been entered. Long running 
programs should check for this condition or should not be running when the 
command ts entered. 


Each program queued for execution is notified of the shutdown request when it 
does its initial T/P 1/O operation after it has been loaded and control has been given 
to it initially. 


You can enter other commands as long as the CCP is running. You can enter the 
DISPLAY USERS and DISPLAY TERMINALS commands to determine the number 
of programs waiting to be initiated and the terminals in use. 


When all processing of application programs is complete, CCP terminates itself and 
the system is then ready for the CCP to be reloaded or for other System/3 programs 
to be run. 


Notes: 

1. If a number of programs are queued for execution or a large indexed file has 
had records added to it (causing a key sort) a significant amount of time may 
elapse between the SHUTDOWN command and end of job for CCP. 

2. Acommand mode terminal that is in error recovery when you enter the 
SHUTDOWN command is taken out of error recovery in order to receive the 
shutdown message. 

3. If another partition is trying to open/close a file and an error occurs, shutdown 
waits until that error is responded to before trying to close CCP files. 

4. The CCP shutdown phase is not yet completely finished when the SHUTDOWN 
COMPLETED message appears on the system console. Do not cancel the parti- 
tion in which CCP is executing or do another IPL until the partition end-of-job 
message appears. 

5. Entering a time value (5704-SC2 only) causes a SHUTDOWN PENDING message 
to be sent to all command-capable terminals. Operators of terminals using PRUF 
screens will know that they should finish quickly and not start a new series. 

6. If the interval timer (5704-SC2 only) is not supported on your system, entering 
a time value will still cause the SHUTDOWN PENDING messages to be sent; but 
shutdown will not proceed until the SHUTDOWN command without a delay 
parameter is entered. 

7. If, after entry of a delayed SHUTDOWN command (5704-SC2 only), another 
SHUTDOWN command is entered with a different time value, the new value is 
used. If the new SHUTDOWN command is not a delayed SHUTDOWN command, 
a normal shutdown is scheduled. 

8. If $CCPAS or $CCPAL is running in another partition, SHUTDOWN will not be 
allowed. 
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Chapter 4. Entering Terminal Operator Commands and Program Requests from the Console 


The commands available to you when using the console as a command terminal are: 
program request commands 
/FILE 
/Q (queue) 
/NOO (no-queue) 
When the console is used for these operations: 
@ The console is always signed on and does not need to be signed off. 


@ The symbolic terminal name of the console is always CONSOL. 


@ The console does not need a data mode escape facility because the system 
Operator can always enter commands to the system. 


When entering a program request, file command, no-queue command, or queue 
command, you will get the same responses from CCP as a terminal operator. These 
messages are documented in the /BM System/3 CCP Messages Manual, GC21-5170. 
You should be familiar with these messages. 


Specific messages for the system Operator resulting from the commands and program 
requests are also documented in the Messages Manual. 
PROGRAM REQUEST 


To enter a program request from the console, first press the PF9 key. When you Program request 
are prompted, press PF 12 and enter the program request in the following form: 


Additional Information 





program-name : input-data 


After a program name is entered, three possible actions can occur: 
@ The program is started immediately. 


@ The program is placed on a queue (waiting list) until the system resources that it 
requires are available. 


@ The program request is rejected. 
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Request queued 


/FILE command 


File reference names 


Example of using the 
/FILE command 
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If the program request is queued, the console is still available to you to enter 
system operator commands, to receive messages from CCP, user programs, or 
terminals, and to respond to outstanding reply requests. 


After you have entered the program request, CCP will not accept another program 
request, /Q command, /NOO command, or /FILE command until one of the 
following events occurs: 


@ The requested program starts running. 


@ The input data has been read by the program (if input data was allowed with the 
program request). 


@ The request from the queue has been canceled (if the request was queued). (See 
index entry canceling a queued request.) 


/FILE COMMAND 


Enter this command only when you must specify which disk data file should be 
used by a program you will request. 


File Reference Names 


The programs you request typically reference data files stored on a magnetic disk. 
Programs generally reference specific disk data files, and do not need an indication 
of which files to use. 


Some programs, however, are written to access information in one of several 

similar disk files. You are expected to specify which file to access on a particular 
run. Suppose, for example, you work in a school district office. The system you 

use has a separate file for each school in the district; each file contains information 
about the students in that school. If you request a program from the console, it 
accesses one of those files in order to list the students who are absent from school 
that day. Since the program can access any one of the files, it expects you to 

specify which school’s file to use. If you do not specify a file, the program cannot 
know what information to access, and the CCP rejects your request for that program. 


The /FILE command is used to associate the file name used in the program 
(reference-name or symbolic file name; see the description of the SYMFILE assign- 
ment statement in /BM System/3 Model 15 CCP System Reference Manual, 
GC21-7620) with the name of the disk file to be used for a particular run of the 
program (actual-name). The run procedure for the program will tell you the file 
reference-name, the actual-names that may be chosen, and when you should select 
one actual-name as opposed to another. 


Note: While the program is running, using the particular file you have selected, any 
messages you receive concerning the file refer to the actual-name of the file, not 
the reference-name. 


When task chaining (5704-SC2 only), the /FILE specification that may be present 
for the requester is not valid for the requested program. When running a sort 
program, do not try to use the /FILE command to place the output file over the 
input file. 


Associating File Names 


Before requesting a program that needs this information, you specify which disk 
file to use by associating a file reference-name with the actual-name of a file. To 
do this, you use a command of the following format: 


| Command | | Additional Information 
/FILE G reference-name,actual-name 


A /FILE command remains in effect for the next program requested as well as for 
other programs that require a file specification and that make use of the same file 
reference-name. The reference-name/actual-name association is canceled only when: 









@ Another /FILE command is entered associating the same reference-name with a 
different actual-name. 


@ A/FILE command is entered using the same reference-name, but no actual-name 
(see Canceling a File Name Association). 


@ A/FILE command is entered that specifies neither a reference-name nor an 
actual-name (see Canceling All File Name Associations). 


Because you may have to request a number of programs that need a file specifica- 
tion, and because each of those programs might use a different file reference-name, 
multiple /FILE commands may be entered. That is, you can have multiple file 
name associations in effect at the same time, each one associating a different 
reference-name with the actual-name of a disk file. 


Canceling a File Name Association 


You can cancel the association between a file reference-name and an actual-name 
by entering a command of the following format: 


| commans |] | Additional Information 
/FILE jw reference-name 


A command of this form causes the association between this reference-name and 
any actual-name to be cancelled. When this form of the /FILE command has been 
entered, the file reference-name used no longer refers to any specific file. 





Cancel one file 
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Cancel /FILE command 


/Q (queue) command 


Unavailable resources 
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Canceling All File Name Associations 


You can cause all previous reference-names and actual-names to be canceled by 
entering a command of the following format: 


/FILE 


Additional Information 





QUEUE COMMAND 


Use this command to indicate that you are willing to wait for programs that cannot 
start immediately. CCP will then place your request on a waiting list, or queue. 


Unavailable Resources 


When you request a program, and that program cannot start immediately because 
resources it needs are being used by other programs, CCP will normally reject 

your program request. Certain resources may be completely unavailable, and if 
your program needs one of these, CCP will a/ways reject your request. But often, 
resources needed by the program you request may be only temporarily unavailable, 
and in this case CCP will reject your request un/ess you have previously entered a 
queue command. 


When you enter this command, you are indicating that if a program you request 
cannot start because resources are only temporarily unavailable to it, you wish to 
wait for those resources to become available so that your program can run. If the 
program does not have to wait for resources, it starts immediately. 


You cannot enter another program request, /Q command, /NOQ command, or 
/FILE command while you are waiting for a program to begin. However, you 
may enter other commands and responses as necessary. 


You can cancel your program request from the queue. (See index entry canceling 
@ queued request.) 


Entering the Queue Command 


To indicate you are willing to wait for programs to start when resources are 
temporarily unavailable, enter a command of the following format: 


Command Additional Information 





Until you have entered this command, CCP rejects a program request if the resources 
it requires are not immediately available. Once you have entered this command, it 
remains in effect until a no-queue command is entered. 


Note: \f you request a program that uses a punched card device or an online 3741, 
and those devices are not immediately available to the program, your request will 
be rejected, whether or not a /Q command is in effect. 
NO-QUEUE COMMAND 
Use this command to cancel the effect of a queue command. If you have previously /NOQ (no-queue) 
entered a queue command, but you are no longer willing to wait for programs to command 


start when resources are temporarily unavailable, you can cancel the effect of the 
queue command by entering a command of the following format: 


Additional Information 


When you have entered this command, any program request you make will be 
rejected if resources are even temporarily unavailable. 
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Chapter 5. Operational Stage Message Formats 


During operation of the CCP, the system operator can receive messages from the 
following sources: 


@ User programs (CCP user tasks) 

@ ccP 

@ Command terminals 

@ Model 15 system control program routines 

All messages issued during CCP operation are issued through Model 15 system 
logging facilities. Message formats, therefore, are consistent with the format 
described in /BM System/3 Model 15 System Messages, GC21-5076. (See that 


manual for descriptions of all Model 15 system messages.) 


Messages issued by CCP system tasks and CCP user tasks have a component code 


CP and the halt code U— (U dash). As a general rule, the subhalt code is not used. 


(See /BM System/3 Model 15 System Messages, GC21-5076, for descriptions of 
all U— subhalts.) 


IDELETE mode is generally recommended when running CCP because of the 
large number of |-type messages issued by CCP (see (DELETE command in /BM 
System/3 Model 15 Operator’s Guide, GC21-5075). However, you may not wish 
to use IDELETE if CCP user tasks are issuing I-type messages, because you may 
want to acknowledge each message. If you are using IDELETE and user tasks are 


Message sources 


CCP component code 
CP 


U— halt 


IDELETE mode 


issuing I-type messages, you can display the system history area to see messages that 


no longer are displayed on the screen. 
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Your response 
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USER PROGRAM MESSAGES 


CCP user programs (user tasks) issue messages to the system operator by issuing 
CCP output operations to the terminal CONSOL. The first line of the message 
has the standard Model 15 message format {see the /BM System/3 Model 15 
System Messages, GC21-5076, for a description of the standard Model 15 message 
format). The succeeding tine(s) contains the message text—if any—issued by the 
application program. The first line of the message issued by an application 
program will always have the following format: 


x CP U- tnonn reece pppppp 











Program name — name of the user pro- 
gram that issued the 
message. 


Terminal name— symbolic name of the terminal 
that initially requested the pro- 
gram. For an MAT program 
(see index entry}, this is the 
name of the last terminal from 
which the program accepted 
data. 


Maximum length of reply — appears only for R-type 
messages. 


Message type: 1 —~ Information 
R — Reply 


CCP component code (CP) and halt code (U—). 
Task ID — task ID of the CCP user program. Task IDs for 5704-SC1 can be 


3-9, E, G, H, and V-Z; task IDs for 5704-SC2 can be 4-9, E, G, H, and 
U-Z. 


First line identifier — an asterisk in this position indicates the message requires a response 


(R-type messages only); I-type messages require an acknowledge- 
ment if you are not in IDELETE mode. 


If a user program message requires a response, the response is determined either by 
the content of the message or by your program run procedures. To respond, press 
PF12, enter your response, and press ENTER. 


Note: When a user task goes to EJ, all messages it has written to the console are 
removed from the display. As a result, you may not see all messages or a message 
may disappear before you have responded. All messages are available for your 
review on either the log device (if any) or the system history area. If you are 
expecting messages, you should occasionally refer to the log or display the system 
history area to review messages. 


CCP MESSAGES 


Messages to the system operator issued by CCP are in the standard Model 15 
message format (see /BM System/3 Model 15 System Messages, GC21-5076). 

The second line of the message contains the reference number and text of the CCP 
message. See the/BM System/3 CCP Messages Manual, GC21-5170, for descriptions 
of all messages issued by CCP. 


The first line of a CCP message always has the following format: 


= x CP U— tnnn 








Maximum length of reply — appears only for R-type 
messages. 


Message type: D — Decision 
{ — Information 
R — Reply 


CCP component code (CP) and halt code (U—). 


Task ID ~ task ID of the CCP system task that issued the message: 


M = Communications supervisor 
C = Communications manager 

P = Command processor 

T = Terminator 

D = Display Format Facility 


First line identifier — an asterisk in this position indicates the message requires 


a reply; I-type messages require an acknowledgement, if 
you are not in IDELETE mode. 
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MESSAGES FROM COMMAND TERMINALS 


Message 900 Messages from operators of command terminals are issued as CCP messages, with 
message number 900. The format of the first message line is described in the 
preceding topic (CCP Messages). The format of the second message line is: 


900 FROM ‘xx’: text 


xx — Terminal 1D of the sending terminal 
text — Text of the message sent by the terminal operator 


The terminal operator can send up to 75 characters of text to you. Because of a 
Model 15 constraint, if the terminal operator sends a message of exactly 21 
characters or exactly 57 characters, the last character of the message will not be 
visible to you. 


MLTA MESSAGE 


Permanent Error Message 


MLTA permanent error All permanent line and terminal errors that are logged as messages on the console 

message are also logged in the MLTA error file. Complete descriptions of the MLTA 
messages are contained in the /BM System/3 Multiple Line Terminal Adapter RPQ 
Program Reference and Component Description Manual, GC21-7560. This kind of 
message is issued as a CCP message (see CCP Messages earlier in this chapter). The 
text of the message has the following format: 


ML a | LL.TTT,00,S888ss EEEEEEEEE EEEEEEEEE 


| TM 
ML Indicates an MLTA error. 
LN Indicates the error type: 
™ LN is line error 
TM is terminal error 
ik The line number in decimal. 
TTTT The terminal address characters in hexadecimal. 
if the line is not polled, this field contains 
‘0000’. Otherwise, it contains the terminal 
address characters. 
00 Operation code in hexadecimal. 
SSSSSS The status bytes in hexadecimal (HDB positions 


0,6, and 7). 


EEEEEEEEE EEEEEEEEE 
First Message Area 


LOOP FAIL 
INST NOOP 
TIMEOUT 
DATA CHECK 
OVERRUN 
TERM INTR 
LOST DATA 
XMIT ABRT 
RCV ABRT 
ABNL RESP 
SDR ERROR 


One or two abbreviated error messages. 


Second Message Area 


MOD NRDY 
LINE NRDY 
RCV ABRT 

XMIT ABRT 
SDR ERROR 


The abbreviated error message meanings are: 


Abbreviation 


LOOP FAIL 
DATA CHK 
TIMEOUT 
OVERRUN 
XMIT ABRT 
RCV ABRT 
LOST DATA 
ABNL RESP 
MOD NRDY 
LINE NRDY 
INST NOOP 
TERM INTR 
SDR ERROR 


Message 


Loop test failure 

Data check 

Timeout 

Overrun 

Transmission aborted 
Reception aborted 

Lost data 

Abnormal response 
Modem not ready 

Line not ready 
Instruction no-op 
Terminal interrupt 
Terminal address not found in SDR table 
(error not logged in OBR) 
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ONLINE TEST WRITE ERROR MESSAGE 


Online test write If a permanent error occurs when the requested test message is sent to the terminal, 
error message the following actions are taken. 
1. A message is sent by the IOCS to the system operator. This message is issued 


as a CCP message (see CCP Messages earlier in this chapter). The text of the 
message has the following format: 


MLOL#BLL,TTTT,CC 


ML Indicates an MLTA error. 

OL Indicates an online test write error. 
b Blank. 

LL Line number in decimal. 


TTTT The terminal address characters in hexadecimal. If the line is not 
polled, this field contains ‘0000’. Otherwise, it contains the terminal 
address characters. 


cc Completion code for the write error. 


2. The CCP makes a second attempt to write to the terminal if it is a 1050. 


BSCA/BSCC MESSAGE 


BSCA/BSCC message Completion codes are logged on the console. They are issued as a CCP message 
(see CCP Messages earlier in this chapter); the text of the message has the following 
format: 


Al 
BSC ( A2{ CODE cc—(description), 
| C3 ( TERMINAL ADDRESS—(characters) 
C4 


cc = Completion code 

characters = Polling or addressing characters 

terminal address = Printed for control stations only 
Completion codes are described in the /BM System/3 Multiline/Multipoint Binary 
Synchronous Communications Reference Manual, GC21-7573, and in the /BM 
System/3 CCP Data Areas and Diagnostic Aids, SY21-0040. 


BSCA/BSCC ONLINE TEST RESULTS 


BSCA/BSCC test results Test results are logged on the system log device. Results are logged in a format 
depending on the test results. 
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Test Message Transmitted 


This message is issued as a CCP message (see CCP Messages earlier in this chapter). Message transmitted 
The text of the message has the following format: 


TERMINAL ADDR HEX hex 
* NLINE TE T, LINE {1,2,3, at \ 
PUN ee - encom 


MESSAGE TYPE tt, MESSAGE COUNT cc 

ACK RCVD NAK RCVD TIMEOUT INVLD MSG 
xXx XX XX Xx 

* END ONLINE TEST 


TERMINAL ADOR HEX hex identifies the terminal to which the test message 
was sent if the logging station is a control station. 


POINT-TO-POINT indicates the BSC line is a point-to-point line. 
tt identifies the test message type. 
cc is the number of times the test message was to be transmitted. 


ACK RCVD xx is the number of times ACK was received as a reply to the test 
message. 


NAK RCVD xx is the number of times NAK was received as a reply to the test 
message. 


TIMEOUT xx is the number of 3-second receive timeouts recorded during the 
online test by the BSCA/BSCC. 


INVLD MSG xx is the number of invalid replies received in response to test 
messages sent. 


Note: If the terminal receiving the test message is a 328X printer, XX will be 00 in 
all cases and the success or failure of the test must be determined by an inspection of 
the terminal output. 
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Test Message Received 


Message received This message is issued as a CCP message (see CCP Messages earlier in this chapter). 
The text of the message has the following format: 


* BSC ONLINE TEST, LINE 1.2) 3, or 4 os ADDR: HEX: hex 
POINT-TO-POINT 


MESSAGE TYPE tt, MESSAGE COUNT cc 
TXT RCVD DATA CHK TIMEOUT INVLD MSG 
XX xx XX XX 


* END ONLINE TEST 


TERMINAL ADDR HEX hex identifies the terminal that transmitted the test 
message if the logging station is a control station. 


POINT-TO-POINT indicates the BSC line is a point-to-point line. 

tt identifies the test message type. 

cc is the number of times the test message was to be transmitted. 

TXT RCVD xx is the number of times the test message was received correctly. 


DATA CHK xx is the number of data checks recorded during the online test by 
the BSCA/BSCC. 


TIMEOUT xx is the number of 3-second received timeouts recorded during the 
online test by the BSCA/BSCC. 


INVLD MSG xx is the number of test messages received incorrectly for which 
a data check or timeout was not recorded. 


Note: This message will appear only if the requesting terminal is a tributary CPU 
requesting test types 01, 06, or 14. 


Test Failure 


This message is issued as a CCP message (see CCP Messages earlier in this chapter). 
The text of the message has the following format: 


“BSC ONLINE TEST, LINE ey 


TERMINAL ADDR HEX 
4 


POINT-TO-POINT 
MESSAGE TYPE tt, MESSAGE COUNT cc 


[Variable text (see below) ] 
*END ONLINE TEST 


TERMINAL ADDR HEX hex identifies the terminal to which the test message 
was directed. 


POINT-TO-POINT indicates the BSC line is a point-to-point line. 


Variable Text 


NO RESPONSE TO SELECTION—The terminal to which the test message was 
directed did not respond to the address selection. 


RVI RECEIVED TO SELECTION—The terminal to which the test was directed 
was unavailable for selection. 


NEGATIVE RESPONSE TO SELECTION—The terminal to which the test was 
directed responded negatively to selection. 


INVALID RESPONSE TO SELECTION—The terminal to which the test was 
directed has responded with an invalid response. 


ENQ TRANSMITTED 25 TIMES—The terminal to which the test was directed has 
transmitted WACK 25 times. The test has failed. 


LOST CONNECTION—The connection was lost during execution of the test. 


NO CONNECTION-—A point-to-point connection could not be established. 


Invalid Request for Test 


If an invalid request for test is detected, a system message is sent to the system 
log device and written to the operator console as follows: 


IB YT XX I 

INVALID ON-LINE TEST 
where XX is a two-digit code indicating the reason the request was invalid. These 
codes are described in /BM System/3 Communications Control Program Data Areas 


and Diagnostic Aids, SY21-0040, and /BM System/3 Model 15 System Messages, 
GC21-5076. 


Operational Stage Message Formats 69 


70 


Appendix A. Glossary 


BSCA. The Binary Synchronous Communications Adapter is a special feature that Glossary 
allows the system to function as a point-to-point or multipoint processor terminal. 

Operation is half duplex; synchronous: and seria! by bit, serial by character over 

either nonswitched or switched voice grade or better two-wire, four-wire, or wide 

band communication facilities. 


BSCC. The Binary Synchronous Communications Controller is a special feature 
that allows the system to function as a multipoint processor. Operation is half 
duplex; synchronous; and serial-by-bit, serial-by-character over nonswitched voice 
grade or better two-wire, four-wire, or wide-band communication facilities. 


command interrupt mode. The operating mode of a terminal following data mode 
escape until the program execution is resumed by a RUN command (the terminal 
reenters data mode) or until the program is canceled by a CANCEL command (ter- 
minal enters command mode). 


command mode. The operating mode of a terminal following a successful sign-on, 
up to and including the program request. Following program termination, a terminal 
returns to command mode until another program request is made or until signoff. 


command terminal. A terminal that is capable of commanding CCP services related 
to requesting a program. Terminals are designated command or data terminals at 
assignment time. 


data mode. The operating mode of a terminal when it is under control of an appli- 
cation program, until the program terminates, until the terminal is released by the 
program, or until the data mode escape characters are entered. While in data mode, 
a terminal is not in direct communication with the CCP. 


data mode escape. A special CCP function, initiated by a unique string of six char- 
acters entered at a terminal while the terminal is in data mode. The data mode 
escape function interrupts the execution of the application Program and places 
the terminal in command interrupt mode. 


data terminal. A terminal that is not capable of commanding CCP services. A data 
terminal is always either in stand-by mode (not polled for input by the CCP) or in 
data mode (under control of an application program). 


display adapter. An IBM device that converts the binary data stream from the device 
buffer into signals on the communication line, and vice versa. 


initial mode. The operating mode of a command terminal before sign-on at the 
terminal has been accepted by the CCP. 


MLTA. The Multiple Line Terminal Adapter is a special feature that allows the 
system to function as a processor on a point-to-point and multipoint network. 
Operation is asynchronous over either nonswitched or switched voice grade or 
better communication facilities. 
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MRT program. (Multiple Requesting Terminals program) — A program written to 
handle additional requests for it from command terminals while it is still processing 
an earlier request. 


never-ending program (NEP). A user application program which, after it has been 
initiated, normally remains in main storage and does not go to end of job until 
the CCP is shut down, or the program is canceled by the system operator. 


nonswitched line. A connection between a remote terminal and a computer that 
does not have to be established by dialing. 


offline. Pertains to terminals that are not under control of the CCP system. 


online. Pertains to terminals that are under control of the system and are allowed 
to interact with CCP. 


port.! A communication area used by PORTLINE operations. (Refer to CCP 
Programmer’s Reference Manual, GC21-7579, for a description of the PORTLINE 
function.) 


stand-by mode. The mode of a data (noncommand) terminal not under control 
of a user program. 


switched fine. A communication line in which the connection between the com- 
puter and a remote station is established by dialing. Synonymous with dial line. 


symbolic terminal name. The identification of a terminal used by the CCP and the 
system operator to refer to a specific terminal. A user defined symbolic terminal 
name is assigned to each terminal during the CCP assignment stage using the 
TERMNAME statement. The symbolic terminal name CONSOL refers to the 3277 
CRT/keyboard. A symbolic terminal name of blanks refers to the one and only 
requesting terminal of an application program (not MRT program). 


system task. A unit of work for the processing unit from the standpoint of the 
CCP, consisting of a CCP function (as opposed to a user application, or user task) 
that must be performed by the CCP, such as communications management. 


task chaining. The process of requesting initiation of a CCP task from within 
a currently executing CCP task, without requiring system or operator action. 


task ID. Each program running in the system has an internal ID associated with it 
called a task }!D. Because multiple copies of the same program may run concurrently, 
each copy will have a different task ID assigned to it. 


terminal ID. The two-character identification assigned to an actual terminal 
assignment. 


terminal session. The duration of time that a terminal operator is communicating 
with the CCP. It begins at sign-on and ends at sign-off. 


user task. A unit of work for the Processing unit from the standpoint of the CCP, 
consisting of a user program (as opposed to a system function, or system task) that 
must be executed by CCP. 


work session. The duration of time that the terminal Operator is permitted to 
communicate with CCP. It begins when you start CCP and ends when you shut- 
down the CCP. 
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Appendix B. Sample Commands 


This appendix contains examples of the CCP system operator commands and the 
CCP responses to the commands. Both the commands and the responses are shown 
here, although in practice the commands are no longer visible when the responses 
appear. The system operator commands are described in Chapter 3. Controlling 
the CCP after Startup. 


Assign Symbolic Name and Terminal Physical Identification ASSIGN command 


ASSIGN SECDRY,'M2! 
375 NAME ASSIGNED,!M2' NAME IS NOW SECDRY 


Activate the Automatic Error Recovery Facility AUTOERP command 


AUTOERP ON 
408 OK 


Activate the Automatic Error Recovery Facility 
and/or Change the Time Interval 


AUTOERP ON,05 
408 OK 


Deactivate the Automatic Error Facility 


AUTOERP OFF 
408 OK 


Cancel Using Task Identification and Program Name CANCEL commands 


CANCEL CCP,3;MRRPGL 
480 CANCEL OK 
526 MRRPGL TASK-3 CODE-2A DUMP#-3 


Cancel CCP 


CN CCP 

480 CANCEL OK 

502 CANCEL STARTED 

503 CCP CANCEL COMPLETED 
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CLOSE command 


OPEN command 


DISPLAY commands 
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Close BSCA Line (5704-SC2 only) 


CLOSE LINE1 
310 LINE CLOSED 


Open BSCA Line (5704-SC2 only) 
OPEN LINE2 


312 LINE OPEN, READY TO BE VARIED ON 


Display Terminals 


DISPLAY TERMINALS (or D T) 

BEAK OK OK 3K 3K 2K 2K 2k afc afc 2k 2k ai ak ac ak 2k ai 2c ak sik afk afk alk afk akc ae ak afk alk ale ate ac akc ok 3 
x E 

* ID NAME MODE PROGRAM 


* M3 N272CA DATA Q-MRCOBL 
* BO N32102 INIT 
* BL N32422 INIT 
First * B2 N32L21 INIT 
ge PES NS Buse 5 1BY 
* B4 N32142 CMD 
* B6 N32202 OFF 
B7 N32221 OFF 
B8 N32212 OFF 
ENTER DISPLAY REQUEST | 


FI ICI AK CR Ik ICI IC 2K ak aK a akc ak ak ak aI aK 


se ye 
% 3 


a 
7 


He ak aK ak ak ac ak ak ak akc akc akc 3k 


a 


% 


AEE OES BK FE OE OK I OK OK OIC OIC 2K OK 
R 

ID NAME MODE 
N32302 OFF 
K N37SA  CMDI 
* M2 N37SX INIT 
NLO5X INIT 
N272CX DATA 
M6 N27C DATA 
M7 N274L INIT 
N2741D INIT 
M9 N27DC DATA MRCOBIL 
ENTER Dror Ee RESEE ST) 


3k ole oh ok ok ole ofc ate ok 
as DE AE A AK OIC I 


‘“ 
% 


PROGRAM 


ee HK 
sw 
oO 


MRCOBL 


¢ 
= 
fu 


MRCOBL 
MRCOBL 


Second 
page 


He HG 
= 
© 


3k ok ok ok of 


x 


ok ale ake ok ake ake afk afc ok ok ok alk ofc ak 3 ie oie ok CHE IK OIC > 


HK 3K 3c ale ai ok ak aie ok oi ok ole aie oi ok ak alk 3k 3k oie 3} 


OLT ERP 


MSG NOT RSP 09 * 


AK IK 3x ake ok 


cate ok 3k 


* 


- 
% 


MSG nee RSP a *K 


OIC Sic eae 


Display Terminal Assignments 


eee TERMID (or D A) 


te Sle gle gle ale se weg dle se ote sle ste le ate he ste cle she ale ale se le 
BKC AC IC 3K OIC OKC IC ic 3g 2 ac afc ak alk ale akc afk of ale ake ok ake ok ake ok ok of 


NM 

w 
x“ 
5 
+ 
7 
% 
% 
4 


wa 
3 


* ID NAME ID NAME ID NAME * 
*x M5 N1LO5X BL N32112 M2 N37SX * 
* M6 N27C B2 N32121 SCNDRY *k 
* MO N27DC B3 N32132 ES 
* M3 N272CA B4 N32142 * 
* M4 N272CX B6 N32202 * 
* MY N2741 B8 N32212 *k 
* M8 N2741LD BY N32221 * 
* BS N32002 BI N32302 > 
* BO N32102 Mi N37SA * 
* ENTER DISPLAY rane MSG NOT RSP 09 

IS DIK SIS DIK SIC SIE SIS Ok 3K afc aie ole alk aig alk otc ole ate ste afk ate ake > IS DKK OIC SI Sc ale ofc ok alk ole ofc ole akc ok afk alk ake ok ak 


Display Users 


DISPLAY USERS (or D U) 





DIK 3 3c OK ais ake ok ole HE AIS IS AE IE OC IS OK 2K Kg OC ie 2k afc afc aks ak ak ak ak ak ac af afe akc ak afc ok afc afk ok afk ate of 
x as pod 
* 'TERMNL. PROGRM LOC SIZE STATUS 2 
* O6-N37SX.MRCOBL 108K 4K ACT 4 


* S-N272CA.DCPFRC 92K 22K ACT 


* 4-N272CX.CCPIVP 104K 4K ACT *k 
ok & Primary 
3K * display 
K ok 
x LARGEST FREE SPACE 12K? » 
* LARGEST UPA=12K TP BUF=296, 842° > 
* ENTER ae eee MSG NOT RSP 09 x 
CE IC I CE BK IC IS IE a I IC IC 2 OIC ake ak aI a a akc ak aK a ok akc afc ake ak ak ak ak ak afc ae ake fe ae ake ak 
FCI ICI ICICI I ICICI CAI SICK a II I AICI aK aK 2K I aK aK a 2k 2K ak 2k 2k ak 2K 
*«R ok 
* TASK-5 NAME-N272CA.DCPFRC K 
* ATTR-MRT ( 1) cs 
* U/R-NONE x 
* TERMINALS-— M3,N272CA,DATA,INVITE * Secondary 
* DISK FILES-INXORD45,DIRORD45 * display 
= * (task ID=5) 
xs & 
K x 
2 K 
ok * 


* ENTER DISPLAY REQUEST MSG NOT RSP 09 * 


BI I I I IOI ICI ICICI IK I aK a a II I I I aI ae aI a a a ak aK ACK ac ake a ak a ae 


1 REQSTR for 5704-SC2 
25704-SC1 only 


3 
8704-SC2-only Appendix B. Sample Commands 77 


ERP commands ERP Using Physical Terminal Identification and Retry 


MLTM 02,AFO02,23,008002 TIMEOUT 
410 OUTPUT ERROR ON 'M3! 

416 'M3' IN CCP ERROR RECOVERY 
ERP MS! yRETRY 

400 ERP ACCEPTED 


ERP Using Physical Terminal Identification and Bypass 


MLTM 02,AFO02,23,008002 TIMEOUT 
410 OUTPUT ERROR ON 'M3! 

416 'M3' IN CCP ERROR RECOVERY 
ERP 'M3',BYPASS 

400 ERP ACCEPTED 


ERP Using Line Number and Retry (5704-SC2 only) 


MLTM 02,AF02,23,008002 TIMEOUT 
410 OUTPUT ERROR ON 'M3! 

416 'M3' IN CCP ERROR RECOVERY 
ERP LINE2,RETRY 

400 ERP ACCEPTED 


ERP Using Line Number and Bypass (5704-SC2 only) 


MLTM 02,AF02,23,008002 TIMEOUT 
410 OUTPUT ERROR ON 'M3! 

416 "M3" IN CCP ERROR RECOVERY 
ERP LINE2,BYPASS 

400 ERP ACCEPTED 
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Message 


MSG 'M3', TEST MESSAGE TO TERMINAL 'M3! 


Resume Users 


RESUME USERS 
460 OK 


Resume Using Task Identification and Program Name 


R L»MRRPGL 
460 OK 


Resume Initiation 


RESUME INIT 
460 OK 


Resume Initiation by Program (5704-SC2 only) 


RESUME INIT,yMRRPG1 
460 OK 


Resume Commands 


RESUME COMMANDS 
460 OK 


Shutdown CCP 


SHUTDOWN 

500 SHUTDOWN ACCEPTED 

502 SHUTDOWN STARTED 

503 CCP SHUTDOWN COMPLETED 


SHUTDOWN 5 (5704-SC2 only) 
509 SHUTDOWN IS PENDING 

(After a delay of 5 minutes) 

500 SHUTDOWN ACCEPTED 

502 SHUTDOWN STARTED 

503 CCP SHUTDOWN COMPLETED 


MESSAGE command 


RESUME commands 


SHUTDOWN commands 
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SUSPEND commands 


TEST commands 
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Suspend Users 


SUSPEND USERS 
440 OK 


Suspend Using Task !dentification and Program Name 


SUSPEND 1,MRRPGL 
440 OK 


Suspend Initiation 
SUSPEND INIT 
440 OK 

Suspend Initiation by Program (5704-SC2 only) 
SUSPEND INIT,MRRPG1 


440 OK 


Suspend Commands 


SUSPEND COMMANDS 
440 OK 


Test Using Symbolic Terminal Name and Test Number 


T N272CA,!'2! 
378 START TEST ON 'M3! 
390 'M3' ONLINE TEST ENDED 


Test Using Symbolic Terminal Name and Loop 


TEST N272CA,'2',LOOP 
378 START TEST ON 'M3'—LOOP 


Test Using Symbolic Terminal Name and Stop 


TEST N272CAsSTOP 
379 STOP LOOP TEST ON ‘M3! 
C/390 'M3' ONLINE TEST ENDED 


Test Using Physical Terminal Identification and Test Number 


T 'M3B't,!2! 
218: START TEST: ON. M3! 
390 'M3*' ONLINE TEST ENDED 


Test Using Physical Terminal Identification and Loop 


TEST 'M3','2',LOOP 
378 START TEST ON 'M3'-LOOP 


Test Using Physical Terminal identification and Stop 


TEST 'M3',STOP 
379 STOP LOOP TEST ON 'M3! 
390 'M3' ONLINE TEST ENDED 


Test Using Symbolic Terminal Name, Test Number, and Times Sent 


TEST N32102,6,;,01 
378 START TEST ON 'BO! 
390 'BO' ONLINE TEST ENDED 


Test Using Symbolic Terminal Name, Test Number, Times Sent, and Message 


T N32101,0,02,MESSAGE 
378 START TEST ON 'BO! 
390 'BO' ONLINE TEST ENDED 


Test Using Physical Terminal Identification, Number and Times Sent 


TEST 'BO',14,04 
378 START TEST ON 'BO! 
390 'BO' ONLINE TEST ENDED 


Test Using Physical Terminal Identification, Test Number, Times Sent, and Message 


T 'BO',O0,04,yMESSAGE 
378 START TEST ON 'Bo! 
390 'BO' ONLINE TEST ENDED 


Appendix B. Sample Commands 


81 


TRACE commands Trace On 


TRACE ON;MLTA 

420 OK 

TRACE ON;BSCA 

420 OK 

TRACE ON,CCP,,DISK 
432 DISK TRACE ON 
TRACE OFF,CCP 

432 DISK TRACE OFF 
E ON,ALL»32,DISK 
432 DISK TRACE ON 
TRACE ON+CCP 

430 TRACE ON 
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Vary Online Using Symbolic Terminal Name 


V N27SA,0N 
320 'ML' VARIED ONLINE AS N27SA 


Vary Offline Using Symbolic Terminal Name 


V Ni050X,0FF 
321 TERMINAL BEING VARIED OFFLINE 


Vary Online Using Terminal Physical Identification 
V 'ML',0ON 
320 'ML' VARIED ONLINE AS N27SA 


Vary Offline Using Terminal Physical {dentification 


V 'ML',OQFFLINE 

321 TERMINAL BEING VARIED OFFLINE 
Vary Online Using Line Number (5704-SC2 only) 

V LINE3,0N 

320 'BO' VARIED ONLINE AS N275A 

320 'B1' VARIED ONLINE AS N275B 

320 'B4' VARIED ONLINE AS N275D 
Vary Offline Using Line Number (5704-SC2 only) 

V LINE4,0OFF 


321 TERMINAL BEING VARIED OFFLINE 


VARY commands 
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Appendix C. Main Storage Dump to Printer Program ($CCPDD) 


$CCPDD FOR 5704-SC1 


$CCPDD is used to print main storage dumps that have been written in $CCPFILE Print storage dumps 
(the assignment file) during a CCP run. $CCPDD can be executed at either of the 
following times: 


@ During CCP operation, when $CCPDD is run as a user task. In this case, $CCPDD When to run 
must be described by a // PROGRAM statement in the current assignment set. $CCPDD 
The following parameters are required on the // PROGRAM statement: NAME- 
$CCPDD,PRINTER-YES, and PGMDATA-NO. If the printer is not available 
when $CCPDD is called, the pointers are reset and the dumps are not accessible 
until after CCP shutdown. 


@ Immediately after a CCP run and before any system manipulation of $CCPFILE 


such as a COPY or a MOVE. (Any such system manipulation of $CCPFILE could 
invalidate the disk pointers within the $CCPFILE directory. 


$CCPDD cannot be run in the non-CCP partition while CCP or any CCP component 
(such as assignment build or assignment list) are active. 


When $CCPDD is run as a CCP user task, it always prints all dumps from $CCPFILE. Control statement 
If it is run after CCP shutdown, it is controtled by a // DUMP control statement 

that is entered with the OCL for the program. The // DUMP control statement 

allows you to: 

@ Print a specific storage dump 

@ Print all storage dumps 


@ Print the failing user task from a specific storage dump 


Multiple // DUMP control statements are accepted. The format of the // DUMP 
control statement is: 


n [,USER] 
DUMP : 

ut a 

n The one- or two-digit number of the specific dump being re- 
quested. This number is given in CCP message 526 when a user 
program terminates abnormally. 

ALL Indicates all storage dumps are to be printed. 

USER Indicates that only the user task portion of the specified storage 


dump (n) is to be printed. 
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OCL for Running $CCPDD (5704-SC1) 


The following OCL statements are required to run $CCPDD under 5704-SC1: 


// LOAD $CCPDD,unit unit = F1, R1, F2, or R2 
// FILE NAME-$CCPFILE,UNIT-unit, unit = Location of disk con- 
PACK-name taining $CCPFILE 


name = Name of disk pack 
// RUN 
* (optional comment statement) 
// DUMP (see statement format) 


[ 


$CCPDD FOR 5704-SC2 


When $CCPDD is run as a user task or in batch mode, several options are 
available via a control statement. One control statement per load of $CCPDD 
is allowed, with up to three options selected. 


The control statement format is 


XX-VVVY XX-YVVY,XX-YYVY 


where 


xX = 01-99 Select that specific dump 
= AL Print all dumps from $CCPDUMP file 
= CL Clear all dumps from $CCPDUMP file 
(yyyy option not applicable) 
= TR Print trace data from $CCPDUMP file 
(yyyy option not applicable) 
= bb A blank control statement defaults to a FULL option 
for all dumps in the file 
yyyy = CCPR Print the resident CCP 
= CEFE Print a CEFE-type dump with real addresses 
= DIAG Print these diagnostic areas as a debugging aid: 


System COMMON 

Transient area descriptor 

TCBs and associated RBs 

1OS queues 

System error task queue 

$CCCOM 

Share DTF address list 

TUBs 

Queue of TUBs on AUTOERP queue 
Queue of active TP requests 

Active share DTFs and associated FSQEs 
Failing task and termination code 

ATRs and storage protect table of failing task 
Registers of the failing task 


= EPIL Print the external pointer list 

= FAIL Print the failing task and its registers only 

= FSAL Print the file share area 

= FULL Includes DIAG, SPVR, CCPR, USER, and FSAL 

= SPVR_ Print the supervisor 

= TCBC Print the communication Processor TCB mapped in 
addresses 

= TCBD Print the display format facility TCB mapped in 
addresses 

= TCBL_ Print the CCP TCB logical mapped in addresses 

= TCBM Print the BSC communication scheduler TCB mapped 
in addresses 

= TCBP Print the command processor TCB mapped in addresses 

= TCBT Print the termination TCB logical mapped in addresses 

= TPBF Print the TP buffer 

= USER Print all user tasks and their registers 


The yyyy option is not allowed with xx options CL and TR. 
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OCL for Running $CCPDD (5704 SC2) 


Batch 
// LOAD $CCPDD,unit unit = F1, R1, F2, or R2 
// FALE NAME-$CCPDUMP,UNIT-unit, unit = Location of 
PACK-name $CCPDUMP file 
(D1, D2, D3, D4) 
// RUN name = Name of disk pack 


Control statement 
/* 
CCP 


Use a program request followed by control statement information as program 
data, in the following format: 


$CCPDD xx-yyyy,xx-YYYY,XX-YYVY 


Appendix D. Online Tests 


The online tests enable you to test a line connection without interrupting data trans- Online tests 
fer on other lines. The tests consist of sending a known message over a line, then 

determining whether or not the message was received correctly. Test results for 

BSCA are logged on the device assigned as system logging device when the test is 


completed. 
An online test only indicates line conditions existing at the time of the test. If the What to do in case 
test reveals the presence of line problems, you must decide whether or not the of errors 


probability of successful transmission is great enough to justify continued trans- 
mission over the line. 


Compare online test results in conjunction with the terminal statistics as logged in 
the MLTA error file (MLTERFIL) to discover significant trends in the appearance 
of line problems. 


MLTA ONLINE TESTS FOR THE 1050, 2740/2741, AND CMCST TERMINALS MLTA online tests 


Use the TEST command to initiate an online test for an MLTA terminal. You 
must supply the test number when issuing the command. The following chart 
shows the test title, test number, and description of the test. 


All Characters 2 Prints the standard character set for check- 

Test out of the terminal 

Tilt Test 3 Checks the IBM SELECTRIC® print 
mechanism 

Rotate Test 4 Checks the IBM SELECTRIC® print 
mechanism 

Twist Test 5 Checks the IBM SE LEcTRIC® print 
mechanism 

SE LECTRIC® 6 Analyzes the carrier return mechanism to 

Analyzer Test determine if it performs within specifications 
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BSC test—CPU only 


Device Counter Logout 
program $$BSDL 
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BSC ONLINE TESTS 


Use the TEST command to initiate an online test for a BSC terminal. You must 
supply the test number when issuing the command. The following chart shows 
the test number and description of the tests. 


0 The remote station receives and acknowledges the test 
message the specified number of times. The test mes- 
sage must fit on one line. 


1 The remote station transmits the test message the 
specified number of times. The formatted test request 
must fit on one line. 


6 The remote station transmits 36 alphameric characters, 
A-Z and 0-9, the specified number of times. The char- 
acters are transmitted in ASCII (ASCII adapter only). 


14 The remote station transmits 36 alphameric characters, 
A-Z and 0-9, the number of times specified. The char- 
acters are transmitted in EBCDIC (EBCDIC adapter 
only). 


BSC Counters 


BSC counters and statistics are recorded in main storage during execution and 
logged to disk when a BSC file is closed or before an online test. After CCP 

has terminated, BSC counters and statistics can be displayed by the Device Count- 
er Logout program ($$BSDL). For a description of the operating procedures re- 
quired to display the statistics, see the /BM System/3 Model 15 Operator’s Guide, 
GC21-5075. 


MLMP compiles the following statistics as it monitors receive and transmit 


operations: 

1. Number of text blocks sent successfully. 

2. Number of text blocks received successfully. 

3. Number of negative acknowledgements (NAK) received in response to text 
sent. 

4. Number of data checks that occurred on text received. 

5. Number for forward aborts received. A forward abort received is: 
Received TT ror or DISC 

\ / 

Transmitted NAK 


6. Number of EOTs (SBCERR completion code) received in response to data 
transmitted. 


7. Number of adapter checks that occurred while transmitting. 
8. Number of adapter checks that occurred while receiving. 
9. Number of invalid responses received to text transmitted. 


10. Number of inquiries (ENQ) sent in response to positive acknowledgements 
(ACK). 


11. Number of biocks received from which data was lost. 

12. Number of disconnect timeouts and abortive (cancel) disconnects. 
13. Number of timeouts that occurred while receiving text. 

For multipoint control stations, the following statistics are also recorded. 
1. Number of unsuccessful transmissions for each terminal address. 


2. Number of successful transmissions for each terminal address. 
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Appendix E. Close/Open CCP Files Program ($CCPCO) 


$CCPCO FOR 5704-SC2 ONLY 


A program to close/open the CCP files is distributed with CCP, but executes 

in a batch partition. This program, called $CCPCO, gives the user the ability to 
close any existing main data area disk file specified during startup, without shutting 
down CCP. Once this program has been executed (and the specified file closed), 
the user in the batch partition can sort the file, enlarge it, reorganize it, delete 
records, create as null, and so on. This program can then be used to reopen the 

file for CCP access. 


Control Statements 


// CLOSE FILE-filename 
// OPEN FILE-filename 


The CLOSE statement names the file to be closed from the CCP partition. The 
OPEN statement names the file to be reopened for CCP access. 


Keyword Description 


FILE The FILE keyword must be followed by the filename 
specified on the OCL FILE statement. The FILE 
statement in $CCPCO and the CCP startup OCL FILE 
statement must reference the same file. 


Sample OCL 


// LOAD $CCPCO,F 1 

// FILE NAME-INV,UNIT-D1,PACK-VOLD1 

// FILE NAME-TRANS,LABEL-DEC78,UNIT-D2,PACK-VOLD2,DATE-030478 
// FILE NAME-MULTI,UNIT-’D1,D2’,PACK-’VOLD1,VOLD2’ 

// RUN 

// CLOSE FILE-INV 

// OPEN FILE-TRANS 

// CLOSE FILE-MULTI 

// END 
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Explanation: 


The first CLOSE statement will cause the file INV specified in the FiLE keyword 
to be removed from the CCP partition and closed. 


The OPEN statement will cause the file DEC78 with DATE-030478 (previously 
closed by $CCPCO) to be restored and reopened in the CCP partition. 


The last CLOSE statement will cause the multivolume file FI!LE-MULTI to be 
closed on D1 and D2. 


After the file is opened or closed, the appropriate message will be displayed on the 
log device. 


Single volume file: 


rs » JOPENED 
FILE ‘filename ay 


Multivolume file: 


17 » JOPENED tor 
FILE ‘filename foreNep) Vol ‘# 


Programming Considerations 
@ Only one copy of $CCPCO can be executing in the system at a time. 


@ Files opened as output under CCP cannot be closed or opened by $CCPCO. 
In order to be processed, these files must be created as null files and processed 
with add access under CCP. 


@ When $CCPCO requests a file that is being used by a CCP task, a message will 
be issued. The operator will be given three options: 
— Ignore the request (option 0Q). 
— Retry the request (option 1). If the file is in use by another batch partition, 
the 1 option is not allowed. 
— Terminate $CCPCO (option 2). 


e $DCOPY/$COPY/$F COMP cannot move or backup data areas where files have 
been closed by $CCPCO. 
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Appendix F. System History Area Copy Program ($HACCP) 


$HACCP FOR 5704-SC2 ONLY 


The System History Area Copy Program, $HACCP, is used to copy the current 
portion of the System History Area (SHA) to a user-defined disk file. This 
program runs only under control of CCP. 


$HACCP is designed to be automatically invoked when the SHA is nearly 
full, but it can also be manually invoked by the system operator at any time 
(using the PF9 key). $HACCP cannot be invoked from a terminal. 


Note: The $HIST program can also be used to save the contents of the SHA. 


However, $HIST requires a batch partition and cannot be automatically 
invoked. 


User Requirements 


The user must define on a main data area, a file, named $SHAFILE, with a record 
length of 128. The format of the records written to $SHAFILE is the same as the 
format of the records that $HIST writes to the $HISTORY file. 


$SHAFILE must also be defined in the CCP assignment set as having consecutive 
add (CA) data management. This allows subsequent executions of the program 

to add new records to those already existing in the file. To access the information 
in $SHAFILE, a user-written program is required. 


To use $HACCP, you must have these statements in your CCP assignment set: 
// DISKFILE NAME-$SHAFILE,ORG-C,RECL-128 
// PROGRAM NAME-$HACCP,PACK-PROGRAM,PGMDATA-NO, 
FILES-‘$SHAFILE/CA’ 


If SHACCP is to be automatically invoked when the history area is nearly full, 
then the following statement must also be in the assignment set: 


/1 SYSTEM MAXCHAIN-nn 


SHACCP requires 8K of the CCP user program area. 
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Operating Considerations 


The SHA halt status can be changed by means of the HALT SHA or NOHALT SHA 
commands. If $HACCP is to be automatically invoked, the following OCC must 
be entered: 


HALT SHA,CCP [,TRACKS-n]! 


This condition remains in effect until IPL is performed or until a HALT SHA or 
NOHALT SHA command is entered. 


To permanently establish automatic invocation, the Configuration Record Program 
($CNFIG) can be used to set the automatic function with the following statement: 


// SHA HALT-CCPAUTO [,TRACKS-n]? 


For further information on how to establish automatic execution, see $CNFIG in 


the /BM System/3 Model 15 System Control Programming Concepts and Reference 
Manual, GC21-5162. 


After each exectuion of $HACCP, an information message is issued giving the 
number of records added to $SHAFILE and the number of records left in 
$SHAFILE before it fills. If SSHAFILE is filled while the program is copying 
to it, a decision message is issued, and the file must be emptied before $HACCP 
can be successfully run again. 


lf CCP terminates abnormally, the $HAFILE will not be closed and records could, 
as a result, be lost. For more information on recovery procedures, see that section 
in the /BM System/3 CCP System Design Guide, GC21-5165. 


1The TRACKS parameter can be any integer value up to 10, but not greater than half the size 
of the SHA. This parameter is used to set the wraparound warning point of the SHA, and is 
not required unless a warning point of 0 is currently in effect. 
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